Bank Account

Required Inputs

Input
Value

country

NG

id_type

BANK_ACCOUNT

bank_code

The 3-digit CBN issued code for the bank. The full list of supported banks is listed below.

id_number

Bank verification number

Response Fields

Response Field
Value Returned

Country

YES

IDType

YES

IDNumber

YES

IssuanceDate

NO

ExpirationDate

N/A

FullName

YES

DOB

NO

Photo

NO

PhoneNumber

NO

PhoneNumber2

NO

Document

NO

Gender

NO

Address

NO

All fields are returned as a string.

The BANK_ACCOUNT service returns only the names of the bank account holder.

ID Number Regular Expression (Regex)

To limit the probability of your user mistyping the id number, we advice that you enforce the format of the id number field in your app. You can use the regex below:

  • /^[0-9]{10}$/

Supported Products

The Nigeria bank account can be used on any of the following products:

For the supported integration options, you can check the integration options supported by each product here.

Sample ID Numbers

To test the Nigeria BANK_ACCOUNT in our Sandbox, we provide you with 5 different id numbers to mirror various scenarios you can experience with real IDs in production.

ID Number
Result
Result Code

0000000000

Success with PII return

1012

0000000001

Failure, no record found

1013

0000000002

Invalid ID number format

1014

0000000003

Database unavailable/unknown network issue

1015

0000000004*

Success with custom PII return

1012

* You can read more about customising the PII response in sandbox in our documentation here.

Bank Codes

Bank
Bank Code

Access Bank

044

Access Bank (Diamond Bank)

063

Ecobank

050

Enterprise Bank

084

Fidelity Bank

070

First Bank

011

First City Monument Bank

214

Guaranty Trust Bank

058

Jaiz Bank

301

Keystone Bank

082

Mainstreet Bank

014

Polaris Bank

076

Stanbic IBTC

221

Skye Bank

076

Sterling Bank

232

Union Bank

032

UBA

033

Unity Bank

215

Wema Bank

035

Last updated

Was this helpful?