Transaction Status
Query real-time double-entry ledger status for any transaction ID across C2B, B2C, or Escrow.
Request Headers
| Header | Type | Status | Description |
|---|---|---|---|
Authorization | string | Required | Bearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token) |
GET/v1/transactions/:idLive & Sandbox
Query Parameters
| Parameter | Type | Status | Description |
|---|---|---|---|
reference | string | Required | Ledger 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"
}