Verify Account Number

Changed on

This API lets you verify a bank account

post/core/accounts/resolve

Request

Request body

accountNumberstring

The account number. This is required for NUBAN accounts. For ZAR, send the full PayShap ID in the format number@bank, for example 0713058274@nedbank. There is no digit or length rule for ZAR.

bankCodestring

The bank code. This is required for NUBAN accounts and when currency is ZAR. For ZAR the value is PAYSHAP_ID, which is returned by the List banks endpoint.

bankSwiftCodestring

The bank swift code. Use this for GHS bank account verification

mobileMoneyCodestring

Required for type=mobile_money

type'bank_account' | 'mobile_money' | 'nuban' | 'iban' | 'interac_etransfer' required

The type of account number

ibanstring

The international bank account number.

currencystring

The currency, i.e NGN, GHS, ZAR. Note, this is only required for bank_account and mobile_money. For interac_etransfer, the value must be CAD when provided, and it defaults to CAD

interacEmailstring

The recipient's valid Interac email address. This is required for type=interac_etransfer

Response

200

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Account resolve successful",
  "data": {
    "accountNumber": "4038373314",
    "accountName": "Mart Olumide"
  }
}

Changes

    • info

      added the new optional request property

    • info

      added the new interac_etransfer enum value to the request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status