Transaction Status

Query real-time double-entry ledger status for any transaction ID across C2B, B2C, or Escrow.

Request Headers

HeaderTypeStatusDescription
AuthorizationstringRequiredBearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token)
GET/v1/transactions/:idLive & Sandbox

Query Parameters

ParameterTypeStatusDescription
referencestringRequiredLedger transaction reference (path parameter, e.g. AA9F9VPA64W)

Request Code Snippets (cURL, Node, Python, PHP, Go)

Request Example
curl -X GET https://developer.vixzz.com/v1/transactions/TXN_C2B_84920199 \
  -H "Authorization: Bearer vxz_tok_b2c_0a5l1n3m8x2z"

JSON Return Response Body (200 OK)

Response
{
  "transactionId": "TXN_C2B_84920199",
  "type": "C2B_PAYMENTS",
  "amount": 2500,
  "currency": "KES",
  "status": "COMPLETED",
  "accountNumber": "3810482910482",
  "createdAt": "2026-09-07T02:30:00Z",
  "completedAt": "2026-09-07T02:30:14.441Z"
}