Payments API

Get Transactions

View as Markdown
### Get Transactions The **Get Transactions** endpoint retrieves a list of all transactions generated via the **Generate Transaction** endpoint. You can use this to check the actual status of a specific transaction. **Possible Statuses:** - `completed` - `pending` - `cancelled` > A transaction is marked as `cancelled` if it was canceled by the payment gateway, failed, or expired. **Response Fields:** - `provider_reference_no` — the upstream provider reference number; may be `null` or a string. - `other_reference_no` — an additional reference number; may be `null` or a string. #### Usage Tips Always filter by `reference_no` to look up the one transaction you care about — unfiltered or broadly-filtered listing is discouraged and being phased out. Prefer webhooks (`callback_webhook_url`) over polling for routine status tracking.

Authentication

AuthorizationBearer

Bearer token obtained from the Create Token endpoint. Tokens are valid for ~60 minutes — cache and reuse a token for its full lifetime instead of re-authenticating per request.

Query parameters

reference_nostringOptional

Recommended. Look up a single transaction by the reference_no you supplied when creating it. This is the intended way to check a transaction’s status — avoid unfiltered listing.

provider_reference_nostringOptional
Filter by the upstream provider's reference number, when you have it.
channelstringOptional

Filter by channel code (see Get Channels).

statusenumOptional
Filter by transaction status.
Allowed values:
date_fromstringOptional

Start of a date-range filter. Use sparingly — avoid combining date ranges with unbounded pagination for routine polling.

date_tostringOptional

End of a date-range filter. Use sparingly — see date_from.

pageintegerOptional

Legacy pagination. Works today, but don’t build new integration logic around browsing pages of results — look up by reference_no instead.

per_pageintegerOptional<=100

Legacy pagination page size (max 100). See page.

Response

OK
messagestring
dataobject

Errors

401
Unauthorized Error