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.0
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. Please Note: the examples are represented in a json format for easy viewing, however a NDJSON file is returned with multiple entries.

  • Name
    switchingInformation
    Type
    Object
    Tag(s)
    Conditional
    Description

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

  • Name
    switchingServiceForAccount
    Type
    Enum
    Tag(s)
    Conditional
    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)
    Conditional
    Description

    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

{
    "uetr": "13b8472f-d796-436a-ba76-0be4ec234207",
    "partyNameMatch": "MTCH",
    "additionalPartyInformation": {
        "switchingInformation": {
            "switchingServiceForAccount": "ACTIVE",
            "switchedToIban": "NL39SRPY0000000013"
        }
    }
}
Previous