Verify transfer status

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

Store the reference

Save the transfer reference when you create the payout.

Query the status

Call the status endpoint with the transfer reference.

Check the final state

Read data.status to determine whether the transfer completed or failed.

Update your records

Sync your database or dashboard after the transfer reaches a final status.

Notes

Always check data.status before marking a transfer as completed.
A transfer may remain in processing for 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 createdAt and updatedAt; it does not expose completedAt in V1.

Create transfer

Send money to a verified bank account.

Resolve account

Confirm the recipient account before sending money.

Getting Started

Collections

Disbursements

Endpoint

Headers

Path parameters

Example request

Successful response

Possible statuses

How to use this endpoint

Notes

Create transfer

Resolve account

​Endpoint

​Headers

​Path parameters

​Example request

​Successful response

​Possible statuses

​How to use this endpoint

​Notes

​Related guides

Create transfer

Resolve account

Endpoint

Headers

Path parameters

Example request

Successful response

Possible statuses

How to use this endpoint

Notes

Related guides