Payout
Bank List
Nigerian Bank List
Get a list of all supported banks and their codes.
Endpoint: /bank_list
Method: GET
Header
| Param | Type | Required? | Decription |
|---|---|---|---|
| authorization | string | Yes | Set value to Bearer SECRET_KEY |
Path Parameters
| Param | Type | Required? | Decription |
|---|---|---|---|
| currency | string | Yes | Default value is NGN when not set |
Sample Post
curl https://api.budpay.com/api/v2/bank_list
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X GET
Sample Post with currency specified
curl https://api.budpay.com/api/v2/bank_list/NGN
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X GET
Sample Response (NGN)
{
"success": true,
"message": "Bank list retrieved",
"currency": "NGN",
"data": [
{
"bank_name": "9PAYMENT SERVICE BANK",
"bank_code": "120001"
},
{
"bank_name": "AB MICROFINANCE BANK",
"bank_code": "090270"
},
{
"bank_name": "ABBEY MORTGAGE BANK ",
"bank_code": "070010"
},
{
"bank_name": "ABUCOOP MICROFINANCE BANK",
"bank_code": "090424"
},
{
"bank_name": "ACCESS BANK",
"bank_code": "000014"
},
...
{
"bank_name": "WEMA BANK",
"bank_code": "000017"
},
{
"bank_name": "ZENITH BANK",
"bank_code": "000015"
}
]
}
curl https://api.budpay.com/api/v2/bank_list/KES
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X GET
Sample Response (KES)
{
"success": true,
"message": "Bank list retrieved",
"currency": "KES",
"data": [
{
"bank_name": "KCB",
"bank_code": "0001"
},
{
"bank_name": "Stanchart",
"bank_code": "0002"
},
{
"bank_name": "ABSA",
"bank_code": "0003"
},
{
"bank_name": "Bank of India",
"bank_code": "0005"
},
{
"bank_name": "Bank of Baroda",
"bank_code": "0006"
},
{
"bank_name": "NCBA",
"bank_code": "0007"
},
{
"bank_name": "Prime Bank",
"bank_code": "0010"
},
{
"bank_name": "Coop Bank",
"bank_code": "0011"
},
{
"bank_name": "NBK",
"bank_code": "0012"
},
{
"bank_name": "M-Oriental",
"bank_code": "0014"
},
{
"bank_name": "Citi Bank",
"bank_code": "0016"
},
{
"bank_name": "Habib Bank AG Zurich",
"bank_code": "0017"
}
]
}
curl https://api.budpay.com/api/v2/bank_list/GHS
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X GET
Sample Response (GHS)
{
"success": true,
"message": "Bank list retrieved",
"currency": "GHS",
"data": [
{
"bank_name": "ABSA BANK",
"bank_code": "ABS",
"logo": ""
},
{
"bank_name": "ACCESS BANK",
"bank_code": "ACB",
"logo": ""
},
{
"bank_name": "ADB",
"bank_code": "ADB",
"logo": ""
},
{
"bank_name": "AIRTELTIGO MONEY",
"bank_code": "AIR",
"logo": ""
},
{
"bank_name": "APEX BANK",
"bank_code": "ARB",
"logo": ""
},
{
"bank_name": "BANK OF GHANA",
"bank_code": "BOG",
"logo": ""
},
{
"bank_name": "BOA",
"bank_code": "BOA",
"logo": ""
},
{
"bank_name": "CAL BANK",
"bank_code": "CAL",
"logo": ""
},
{
"bank_name": "CBG",
"bank_code": "CBG",
"logo": ""
},
{
"bank_name": "ECOBANK GHANA",
"bank_code": "ECO",
"logo": ""
},
{
"bank_name": "ZENITH BANK",
"bank_code": "ZEB",
"logo": ""
}
]
}