List banks
curl --request GET \
--url https://api.oyapasteaza.com/v1/banks \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.oyapasteaza.com/v1/banks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/banks"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": true,
"message": "<string>",
"data": {}
}{
"status": false,
"message": "<string>",
"code": "<string>"
}Bank Transfer
List banks
Retrieve supported banks for bank transfer disbursements.
GET
/
v1
/
banks
List banks
curl --request GET \
--url https://api.oyapasteaza.com/v1/banks \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.oyapasteaza.com/v1/banks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/banks"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": true,
"message": "<string>",
"data": {}
}{
"status": false,
"message": "<string>",
"code": "<string>"
}Use this endpoint to retrieve banks supported by Pasteaza for bank transfer disbursements.
You need a bank
code when you resolve an account number or create a bank transfer.
Cache the bank list in your application and refresh it periodically. Avoid calling this endpoint before every transfer.
Endpoint
GET /v1/banks
Headers
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Content-Type: application/json
Example request
curl https://api.oyapasteaza.com/v1/banks \
-X GET \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json"
Successful response
{
"status": true,
"message": "Banks retrieved successfully.",
"data": [
{
"code": "044",
"name": "Access Bank Plc"
},
{
"code": "011",
"name": "First Bank of Nigeria"
},
{
"code": "058",
"name": "Guaranty Trust Bank"
},
{
"code": "232",
"name": "Sterling Bank"
}
]
}
Response fields
| Field | Type | Description |
|---|---|---|
code | string | The bank code to use when resolving an account or creating a transfer. |
name | string | The display name of the supported bank. |
How to use bank codes
1
Fetch supported banks
Retrieve the list of banks and store the bank
code and name values.2
Let the customer choose a bank
Show the bank names in your payout or transfer form.
3
Resolve the account
Send the selected bank
code with the account number to confirm the account holder’s name.4
Create the transfer
Use the verified account details to create a bank transfer.
Notes
- The bank list may change as institutions are added or removed.
- Store the bank
code, not only the bank name. - Refresh cached banks periodically to keep your transfer form up to date.
- Use the same bank
codewhen resolving accounts and creating transfers.
Next steps
Resolve account
Confirm an account name before creating a transfer.
Create transfer
Send money to a verified bank account.