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:

  • Name
    switchingInformation
    Type
    Object
    Tag(s)
    Conditionally Returned
    Description

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

  • Name
    switchingServiceForAccount
    Type
    Enum
    Tag(s)
    Conditionally Returned
    Description

    The status of the account that switched to another bank.

    • ACTIVE: The switched account is still activated.
    • EXPIRED: The switched account has been cancelled.
  • Name
    switchedIban
    Type
    String
    Tag(s)
    Conditionally Returned
    Description

    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"
            }
        }
    }
}
Previous
Next