Skip to main content
Use this endpoint to confirm whether a customer has completed payment for a virtual account collection.
Webhooks should be your primary source of truth. Use this endpoint for manual checks, retries, and dashboard reconciliation.

​
Endpoint

GET /v1/collections/virtual-accounts/{reference}/status

​
Headers

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Content-Type: application/json

​
Path parameters

ParameterTypeRequiredDescription
referencestringYesThe Pasteaza virtual account reference.

​
Example request

curl https://api.oyapasteaza.com/v1/collections/virtual-accounts/pst_va_01JABCXYZ/status \
  -X GET \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

​
Successful response

{
  "status": true,
  "message": "Virtual account status retrieved successfully.",
  "data": {
    "reference": "pst_va_01JABCXYZ",
    "merchant_reference": "ORDER_12345",
    "account_name": "JOHN DOE",
    "account_number": "1234567890",
    "bank": {
      "code": "090286",
      "name": "Pasteaza Bank"
    },
    "amount": 500000,
    "amount_paid": 500000,
    "currency": "NGN",
    "status": "successful",
    "paid_at": "2026-06-11T14:12:09Z",
    "created_at": "2026-06-11T13:45:00Z",
    "expires_at": "2026-06-11T14:30:00Z"
  }
}

​
Possible statuses

StatusDescription
pendingVirtual account has been created but payment has not been received.
successfulPayment has been received and confirmed.
expiredVirtual account expired before payment was received.
failedPayment could not be completed or confirmed.

​
How to use this endpoint

1

Find the reference

Store the virtual account reference when you create the account.
2

Send the request

Call the status endpoint with the reference in the URL path.
3

Inspect the response

Check data.status and the payment timestamps in the response body.
4

Sync your records

Update your dashboard or order state after you confirm the payment.

​
Best practices

  • Use webhooks as your primary confirmation method.
  • Use this endpoint for manual verification or dashboard syncing.
  • Check data.status before treating a payment as successful.
  • Store the reference and merchant_reference in your database.

Create virtual account

Create a temporary virtual account for collecting a bank transfer.

Webhooks

Receive real-time payment notifications from Pasteaza.