Requests

      Requests


        Article Summary

        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

        ParameterTypeRequiredDescription
        IBANStringYesCustomer IBAN accountnumber.
        CustomerAccountNameStringYesAccountholder name of IBAN

        Example request

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

        Verify response

        Parameters

        Basic 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
        }
        

        Was this article helpful?

        What's Next