Query Transaction Status

This enables you to directly query the transaction status using the TransactionIDs

Test Endpoint:

https://api.sandbox.pesaway.com/api/v1/mobile-money/transaction-query/

Request Parameters

Request Parameters	Field Description	Example
TransactionReference	A transaction reference for the target transaction	PHYD5AD5ASDF5

Request Sample

curl --location --request GET 'https://api.sandbox.pesaway.com/api/v1/mobile-money/transaction-query/' \
--header 'X-Region: ke' \
--data-raw '{
    "TransactionReference": "PHYD5AD5ASDF5"
  }'

Response Sample

{
  "Reference": "PHYD5AD5ASDF5",
  "PhoneNumber": "2547xx000xxx",
  "Receipt": "QTD5AD5ASDF5",
  "Amount": "5000",
  "Charge": "45",
  "ResultDesc": "Transaction processed successfully",
  "ResultCode": "0"
}

Response Parameters

Response Parameters	Field Type Description
Reference	The PesaWay internal reference for the transaction
PhoneNumber	The receiving phone number
Receipt	MNO receipt
Amount	Amount sent out in the transaction
Charge	Amount charged to facilitate the transaction
ResultDesc	A sentense describing whether the transaction filed or succeeded
ResultCode	A code representation of the results .e.g. 0

Query a refund

Use the same endpoint and TransactionReference field with the gateway RFD-... refund reference. A refund returns ResultCode 101 while processing, 0 when completed, or 2001 when rejected/failed. Additional refund fields include OriginalReference, Status, Stage, Currency, CompletedAt, and FailureReason. Only your merchant’s refunds are returned. See Refunds for details.