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

        Basic parameters

        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