Get Payment/Request Status

Transaction Status Query API

Query the status of a transaction by request ID

This API provides detailed information on the status, results, and metadata of a previously submitted transaction request.

URL Path Parameters

Parameter	Description	Type	Mandatory
organizationId	Unique identifier for the organization	String	Yes
consumerId	Unique identifier for the consumer	String	Yes
requestId	Unique identifier for the transaction request	String	Yes

Response Body Parameters

Parameter	Description	Type
trackingId	Unique identifier for tracking this specific API transaction	String
transactionId	External or provider-assigned transaction ID	String
reference	Unique identifier for the original transaction request	String
status	Status code indicating transaction state (e.g., `S000000` = success)	String
message	Human-readable message describing transaction status	String
error	Error details if any, empty string if none	String
type	Type of transaction, e.g., `Payout`	String
datetimeCreated	ISO 8601 timestamp when the transaction was created	String
lastUpdated	ISO 8601 timestamp of the last update on this transaction	String
datetimeCompleted	ISO 8601 timestamp when transaction completed (if done)	String
result	Object containing transaction result details	Object
request	Original request details sent with the transaction	Object
ipn	IPN (Instant Payment Notification) callback URL	Object
results	Additional results object, nullable	Nullable

Example Response

{
  "trackingId": "01991a17-7328-740a-9b30-1b383a88e985",
  "transactionId": "DRU4S2VE5ZB",
  "reference": "eeadb2fd-ae58-41c4-9b34-4ff514a01613",
  "status": "S000000",
  "message": "Test payment successful, however, no e-value will be disbursed.",
  "error": "",
  "type": "Payout",
  "datetimeCreated": "2025-09-05T13:36:08.488Z",
  "lastUpdated": "2025-09-05T13:36:08.488Z",
  "datetimeCompleted": "2025-09-05T13:36:08.488Z",
  "result": {
    "accountNumber": "254793875319",
    "amount": "1.00",
    "customerFee": "0.00",
    "ref": "fv9n_TDX",
    "storeFee": ""
  },
  "request": {
    "accountNumber": "254793875319",
    "amount": "1",
    "commandId": "ConsumerMobileMoneyWithdrawal",
    "mobileNumber": "254793875319",
    "narration": "Payment"
  },
  "ipn": {
    "url": "https://tanda-tills-ipn.free.beeceptor.com"
  },
  "results": null
}