Verifying bank accounts

Bank account numbers can be verified at a fee through our API. This is useful to verify that important or high value transactions can be confirmed before submission. Verification of a bank account uses a service called Account Holder Verification Service in Real-time (AVS-R) to confirm the account details with the issuing bank. Account numbers can be verified in two ways:

POST: /mandates/{mandateIdentification}/verify/account/real-time

This will verify the bank account number provided with the issuing bank for a given mandate:

  • Rate limit: 1 per second

  • Payload size: 1

POST: /verify/account/real-time

This will verify the bank account number provided with the issuing bank:

  • Rate limit: 1 per second

  • Payload size: 1

The full response model includes:

[
  {
    "accountAcceptsCredit": "string",
    "accountAcceptsDebit": "string",
    "accountAllowsCredit": "string",
    "accountAllowsDebit": "string",
    "accountFound": "string",
    "accountOpen": "string",
    "accountOpenLongerThan3Months": "string",
    "phoneNumberMatched": "string",
    "emailMatched": "string",
    "identificationMatched": "string",
    "nameMatched": "string"
  }
]

Keep in mind, this method does not tell you what the true values of the account holder's name, phone number etc. is - it only lets you confirm if your details match the bank's as a boolean.

Last updated

Was this helpful?