Get Transaction Status
Fetch the status of any payment transaction
GET
https://upesipay.com/api/v2/transaction-status
Headers
| Parameter | Type | Description |
|---|---|---|
| Authorization* | String | Basic auth token |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| reference* | String | The reference that was returned in the original transaction request. You can also pass in the MPESA code of the transaction |
Responses
200 OK
{
"transaction_date": "2026-01-02T08:41:14.160604Z",
"provider": "m-pesa",
"success": true,
"merchant": "Ron Doe",
"payment_reference": "",
"third_party_reference": "SKQ96C7K7H",
"status": "SUCCESS",
"reference": "6b71cb8b-638d-4b6e-9c7c-b0334a641e3a",
"CheckoutRequestID": "",
"provider_reference": "SKQ96C7K7H"
}Notes
- Possible status values:
QUEUED- Payment has been queued and we have not received callbackSUCCESS- Payment has been successfully completedFAILED- Payment failed
Try It Out
Please set your authentication token in the sidebar to test this API.
Headers
Query Parameters
Code Samples
curl -X GET \
'https://upesipay.com/api/v2/transaction-status?reference=9c1c61dd-2085-4137-9b01-8f7fde01c567'