Switch Check

The Switched Account Check is an additional feature that enables PSPs to perform an additional check on the IBAN entered by the user to check if the payee has switched banks. If the payee has switched banks, the API will provide the new IBAN of the payee. The PSP can update the data of the payee accordingly.

Document History

VersionDateDescription
1.015 Jan 2025Original Digital Version. Aligned with PDF V1.3
2.020 Mar 2025Formatting changes. Refer to the detailed changes here.

Go directly to

To activate this add-on please notify service@surepay.nl or contact your Implementation or Customer Success Manager.

Request

To receive the Switching service object for a provided account, there are no changes required in the regular API request.

Response

In the response, the Switching information will be included as an additional object in the additionalPartyInformation object, without any changes in the rest of the response. This additional object will only be returned when the account is found in the switching service.

  • switchingInformationObjectConditional

    Only returned when the account is in a switching service that is supported by SurePay.

    • switchingServiceForAccountEnumConditional

      The status of the account that switched to another bank.

      • ACTIVE: The switched account is still activated.
      • EXPIRED: The switched account has been cancelled.
    • switchedIbanStringConditional

      Contains the new IBAN, where the account holder has switched to. Only returned when the account holder chooses to disclose it.

Request

POST
vopgateway/v1/single
{
    "party": {
        "name": "Daniel Axel Muller"
    },
    "partyAccount": {
        "iban": "NL72SRPY0000000001"
    },
    "unstructuredRemittanceInformation": ["1234512345"],
    "partyAgent": {
        "financialInstitutionId": {
            "bicfi": "ABCDBEBBXXX"
        }
    },
    "requestingAgent": {
        "financialInstitutionId": {
            "bicfi": "SRPYNL2U"
        }
    }
}

Response

{
    "partyNameMatch": "MTCH",
    "additionalPartyInformation": {
        "switchingInformation": {
            "switchingServiceForAccount": "ACTIVE",
            "switchedToIban": "NL39SRPY0000000013"
        }
    }
}
Previous