List dedicated bank accounts
curl --request GET \
--url https://api.oyapasteaza.com/v1/collections/dedicated-accounts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.oyapasteaza.com/v1/collections/dedicated-accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/collections/dedicated-accounts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": true,
"message": "<string>",
"data": {}
}{
"status": false,
"message": "<string>",
"code": "<string>"
}Dedicated Bank Account
List dedicated accounts
List active dedicated accounts for your merchant account.
GET
/
v1
/
collections
/
dedicated-accounts
List dedicated bank accounts
curl --request GET \
--url https://api.oyapasteaza.com/v1/collections/dedicated-accounts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.oyapasteaza.com/v1/collections/dedicated-accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/collections/dedicated-accounts"
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 active dedicated accounts for the authenticated merchant and API key environment.
Endpoint
GET /v1/collections/dedicated-accounts
Headers
Authorization: Bearer sk_test_xxx
Example request
curl https://api.oyapasteaza.com/v1/collections/dedicated-accounts \
-H "Authorization: Bearer sk_test_xxx"
Successful response
{
"status": true,
"message": "Dedicated accounts retrieved successfully.",
"data": {
"accounts": [
{
"externalReference": "CUS_001",
"accountReference": "PZ_DCA_abc123",
"accountNumber": "8023456789",
"accountName": "LUCKY TECHNOLOGIES LTD",
"bankName": "PASTEAZA TEST BANK",
"status": "ACTIVE",
"totalReceived": 500000,
"metadata": {
"customerId": "123"
},
"createdAt": "2026-06-27T10:00:00.000Z"
}
]
}
}
Notes
- Disabled dedicated accounts are not returned as usable accounts.
totalReceivedis returned in kobo.- Use
externalReferenceto map each account to your internal customer, invoice, subscription, or record.
Next step
Retrieve dedicated account
Fetch one dedicated account by reference or account number.
Webhooks
Handle payment notifications for dedicated account credits.