Verify bank transfer status
curl --request GET \
--url https://api.oyapasteaza.com/v1/disbursements/bank-transfer/{reference}/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.oyapasteaza.com/v1/disbursements/bank-transfer/{reference}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/disbursements/bank-transfer/{reference}/status"
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
Verify transfer status
Check the status of a bank transfer.
GET
/
v1
/
disbursements
/
bank-transfer
/
{reference}
/
status
Verify bank transfer status
curl --request GET \
--url https://api.oyapasteaza.com/v1/disbursements/bank-transfer/{reference}/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.oyapasteaza.com/v1/disbursements/bank-transfer/{reference}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/disbursements/bank-transfer/{reference}/status"
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 confirm whether a bank transfer is still processing, successful, failed, or reversed.
Check the transfer status before marking a payout as complete in your system.
Endpoint
GET /v1/disbursements/bank-transfer/{reference}/status
Headers
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Content-Type: application/json
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
reference | string | Yes | The Pasteaza transfer reference. |
Example request
curl https://api.oyapasteaza.com/v1/disbursements/bank-transfer/pst_trf_01JABCXYZ/status \
-X GET \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json"
Successful response
{
"status": true,
"message": "Transfer status retrieved successfully.",
"data": {
"reference": "pst_trf_01JABCXYZ",
"merchantReference": "PAYOUT_12345",
"sourceAccountNumber": "DEFAULT_NGN_WALLET",
"amount": 500000,
"currency": "NGN",
"status": "successful",
"recipient": {
"recipientCode": "rcp_7hK2j9xLmQ4",
"accountNumber": "1234567890",
"accountName": "JOHN DOE",
"bank": {
"code": "044",
"name": "Access Bank Plc"
}
},
"createdAt": "2026-06-11T14:30:00Z",
"updatedAt": "2026-06-11T14:31:12Z"
}
}
Possible statuses
| Status | Description |
|---|---|
processing | Transfer has been created and is being processed. |
successful | Transfer was completed successfully. |
failed | Transfer failed. |
reversed | Transfer was reversed after processing. |
How to use this endpoint
1
Store the reference
Save the transfer reference when you create the payout.
2
Query the status
Call the status endpoint with the transfer reference.
3
Check the final state
Read
data.status to determine whether the transfer completed or failed.4
Update your records
Sync your database or dashboard after the transfer reaches a final status.
Notes
- Always check
data.statusbefore marking a transfer as completed. - A transfer may remain in
processingfor a short period. - The response includes
sourceAccountNumber, which is the Pasteaza wallet/source account that funded the transfer. - Use webhooks for real-time updates when possible.
- Store the transfer reference and merchant reference in your database.
- The status response exposes
createdAtandupdatedAt; it does not exposecompletedAtin V1.
Related guides
Create transfer
Send money to a verified bank account.
Resolve account
Confirm the recipient account before sending money.
Authorizations
Use an sk_test_... key in the playground. Never enter a live key in shared environments.
Path Parameters
Pasteaza reference or supported merchant reference.