GET /lookups/transaction-status

Returns the list of all possible transaction statuses used by the platform. Use this to populate filters in your UI or to validate status values returned by the API.

Endpoint: GET /lookups/transaction-status

Authentication Required: ✅

Request

GET /api/v1/lookups/transaction-status
Authorization: Bearer <ACCESS_TOKEN>

Response

[
  "PENDING",
  "PROCESSING",
  "COMPLETED",
  "FAILED"
]

Status Meaning

Status	Code	Meaning
COMPLETED	0	Terminal. The product was successfully delivered.
PENDING	1	Submitted but not yet picked up by a provider.
PROCESSING	2	Provider has accepted the request and is fulfilling it.
FAILED	3	Terminal. The transaction did not complete; safe to retry as a new transaction with a new merchantReference.

For the full transaction lifecycle, see Transaction Lifecycle.

Polling For Status

To check the status of a specific transaction, use the POST /transactions endpoint with the transactionId you received from /purchase.

---

Last updated: April 2026