v1

latestOpenAPI 3.1.02026-07-2691531.2 KB

Transactions

Get transaction

Returns the full details of a single transaction. Use this to poll for the terminal status of an STK Push or B2C payout if you are not using webhooks.

get/transactions/{id}

Path parameters

idstring uuid required

The transaction ID returned when the payment was initiated.

Response

Transaction details.

successboolean required

requestIdstring uuid required

Unique identifier for this API request. Include in support tickets.

Example response

{
  "success": true,
  "data": {
    "amount": 1000,
    "currency": "KES",
    "phone": "254712345678",
    "accountReference": "INV-2024-001",
    "transactionDesc": "Payment for invoice #2024-001",
    "provider": "m-pesa",
    "providerRequestId": "29115-34620561-1",
    "providerCheckoutId": "ws_CO_191220191020363925",
    "resultCode": "0",
    "resultDesc": "The service request is processed successfully."
  },
  "requestId": "c1b2a3d4-e5f6-7890-abcd-ef1234567890"
}