Bank List
The bank list endpoint helps merchants retrieve the list of banks for countries supported for transfer (NGN, GHS, ZAR and KES).
Authentication
Content-Type
Set value to application/json
Post a request to the URL below, where the base URL is determined by the environment you are in.
GET {{baseurl}}/bank/list/:currency?type=:type
Here are sample requests below.
currency
URL
Yes
Allowed values NGN, GHS, ZAR, KES, UGX, RWF, TZS, and ZMWF
type
Query
No
Allowed values
bank
and mobile_money
defaults to bank
country
Query
No Can be used to get the banklist for other XOF countries aside from Côte d'Ivoire
Allowed values: Côte d’Ivoire, Benin, Togo, Senegal, Mali, Burkina Faso
— defaults to Côte d’Ivoire
Here is a sample response
{
"success": true,
"message": "Bank list retrieved",
"data": [
{
"name": "9mobile 9Payment Service Bank",
"code": "120001",
"id": 302
},
{
"name": "Abbey Mortgage Bank",
"code": "404",
"id": 174
},
...
]
}
Account Name Verification
This endpoint enables merchant verify the identity of the receiver of the transfer, it's recommended that the account name of the recipient is verified before a transfer is done. This is currently available for NGN and GHS only.
Content-Type
Set value to application/json
GET {{baseUrl}}/bank/verify?bankCode=000&accountNumber=6170***&countryCode=GH
Here is a sample response:
{
"success": true,
"message": "successful",
"data": {
"account_number": "2009000000",
"account_name": "JOHN DOE",
"bank_id": 0
}
}
Last updated