Switch Check

The Switched Account Check, also known as “Overstap Check” in the Netherlands, is an additional feature. This feature enables organisations to perform an additional check on the IBAN entered by the user to see if the payee has switched banks. If the payee has switched banks, the API will provide the new IBAN of the payee. The organisation can update the data of the payee accordingly.

To gain access to SurePay's add-ons, customers are required to notify service@surepay.nl first. This notification is essential to enable access to these additional features.

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 account 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. The following table shows the field specification:

switchingInformationObjectConditionally Returned
Only returned when the account is in a switching service that is supported by SurePay.
switchingServiceForAccountEnumConditionally Returned
The status of the account that switched to another bank.

ACTIVE: The switched account is still activated.

EXPIRED: The switched account has been cancelled.

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

Request

POST

v2/account/check/banks

{
    "accountId": {
        "value": "NL18SRPY0000000003",
        "type": "IBAN"
    },
    "name": "Thomas Wilson"
}

Response

{
    "result": {
        "resultType": "MATCHING",
        "account": {
            "status": "INACTIVE",
            "switchingInformation": {
                "switchingServiceForAccount": "ACTIVE",
                "switchedToIban": "NL39SRPY0000000013"
            }
        }
    }
}