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.
Request
JSON Gateway request
JSON
{
"Services": {
"ServiceList": [
{
"Name": "surepay",
"Action": "verify",
"Parameters": [
{
"Name": "iban",
"Value": "NL01INGB0000000001"
},
{
"Name": "customeraccountname",
"Value": "John Doe"
}
]
}
]
}
}Response 200 Status: Ok 400 Status: Access denied 500 Status: Bad request
JSON Gateway response
JSON
{
"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
}