Requests

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.

Verify request

Parameters

Example request

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

Verify response

Parameters

Example response

{
    "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
}