Bank account verification

Steps to verify a customer bank account

For convenience, the bank account verification request (AVSR) is embedded in the mandate creation processes for EFT debit orders and DebiCheck. To include AVSR checks in your mandate requests, set the verifyAccount field = true.

Service input	Matches on	Response body on failure
Bank account number	Bank account number	AccountExists
Branch code		AccountIsOpen
Account type		AccountTypeMatches
		AccountAcceptsDebits
ID number	ID number	IdNumberMatches

If the AVSR request is unsuccessful, the mandate will not be created, and the request needs to be retried with new customer information.

Failure response

Should your AVSR fail, you can expect the following response body:

Request response

  "value": {
    "Message": "Debtor account verification failure: details={\"AccountExists\":true,\"AccountIsOpen\":false,\"AccountTypeMatches\":null,\"IdNumberMatches\":false,\"InitialsMatches\":null,\"FullNameMatches\":null,\"AccountAcceptsDebits\":false,\"AccountAcceptsCredits\":false,\"AccountLengthOpenIsGreater\":true,\"EmailMatches\":null,\"PhoneNumberMatches\":null}"
  },
  "formatters": [],
  "contentTypes": [],
  "declaredType": null,
  "statusCode": 400
}