General

Surepay is an IBAN validation service. Surepay verifies this at the relevant bank, and returns if this is a match, a partial match or a mismatch. In case of a partial match, it returns the actual name the way it is registered at the bank.

A valid Surepay request will always return a successful request, regardless of the validity of the accountholder name. The response from Surepay is returned in the output parameters of the response.

Servicecode and actions

The servicecode for Surepay is 'surepay'

The action is 'verify'

Testing

For Surepay we have a number of test scenario's, which can be triggered by a specific IBAN/CustomerAccountName combination. This will return specific results that Surepay can return. These scenario's can be found at https://support.buckaroo.nl/categorieen/identificatie/surepay

All other scenario's will trigger a successful response, with the following output parameters:

Valid: True Found: True Name validity: VALID Account country code: NL Account status: ACTIVE Account holder type: NP Account holders number: 1 Joint account: False IBAN name matching type: MATCHING

Verify

The verify action returns a successful request, regardless if the account holder matches the IBAN. The results from Surepay will be shared in the output parameters.

View in playground

Request


JSON Gateway request

JSON

copy
{
  "Services": {
    "ServiceList": [
      {
        "Name": "surepay",
        "Action": "verify",
        "Parameters": [
          {
            "Name": "iban",
            "Value": "NL01INGB0000000001"
          },
          {
            "Name": "customeraccountname",
            "Value": "John Doe"
          }
        ]
      }
    ]
  }
}

Response


JSON Gateway response

JSON

copy
{
    "Key": "7984E5BD48CC4D06BE0BC79FXXXXXXXX",
    "Status": {
        "Code": {
            "Code": 190,
            "Description": "Success"
        },
        "SubCode": {
            "Code": "S990",
            "Description": "The request was successful."
        },
        "DateTime": "2022-02-17T15:29:17"
    },
    "RequiredAction": null,
    "Services": [
        {
            "Name": "Surepay",
            "Action": null,
            "Parameters": [
                {
                    "Name": "Valid",
                    "Value": "True"
                },
                {
                    "Name": "Found",
                    "Value": "True"
                },
                {
                    "Name": "Name validity",
                    "Value": "VALID"
                },
                {
                    "Name": "Account country code",
                    "Value": "NL"
                },
                {
                    "Name": "Account status",
                    "Value": "INACTIVE"
                },
                {
                    "Name": "Account holder type",
                    "Value": "ORG"
                },
                {
                    "Name": "Account holders number",
                    "Value": "1"
                },
                {
                    "Name": "Joint account",
                    "Value": "False"
                },
                {
                    "Name": "IBAN name matching type",
                    "Value": "MATCHING"
                }
            ]
        }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "ServiceCode": "Surepay",
    "IsTest": true,
    "ConsumerMessage": null
}