Skip to content
Wajub
Loading keys…

Authorization

default
Authorization<token>

A public key (pk./pk_test.) is accepted on /payments, /customers, /links, /invoices and the catalogue reads (/channels, /providers, /countries, /currencies); anything that moves money out, reads the balance or manages the account answers 406 to it. It is an identifier, never an authorization. Use a secret key (sk./sk_test.) for sensitive operations (transfers, refunds, balance), or a restricted key (rk./rk_test.) scoped to specific permissions. The _test. variant of any key selects the sandbox environment, there is no separate sandbox URL. Never expose your secret key in client-side code.

In: header

Query Parameters

per_pageinteger | null

Max results per page (1–100). Defaults to 25.

pageinteger

The page to read, from 1, for offset pagination. Ignored with `cursor`.

status"pending" | "processing" | "succeeded" | "expired" | "partial" | "failed" | "cancelled" | "refunded" | "partially_refunded"

Filter by status. One of: `pending`, `processing`, `succeeded`, `failed`, `cancelled`, `expired`, `refunded`.

"pending""processing""succeeded""expired""partial""failed""cancelled""refunded""partially_refunded"
date_fromstring | null

Filter from date (YYYY-MM-DD).

date_tostring | null

Filter to date (YYYY-MM-DD).

amount_minnumber | null

Filter by minimum amount (major unit).

amount_maxnumber | null

Filter by maximum amount.

referencestring | null

The payments created with exactly this `reference`. A reference is yours and is not unique: every payment that carries it comes back.

cursorstring | null

The `next_cursor` of a previous response, a numbered page included: switches the list to cursor pagination.

searchstring | null

Search by reference, description or customer details.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.wajub.com/payments?per_page=10&page=2&status=succeeded&date_from=2026-01-01&date_to=2026-01-31&amount_min=1000&amount_max=100000&reference=order-4172"
GET
/payments
{  "code": 200,  "status": "OK",  "message": "Payments retrieved",  "items": [    {      "id": "trx_CSUGajfv9xh0XQ5wu2lx",      "reference": "order-4172",      "amount": 25000,      "amount_paid": 25000,      "currency": "XAF",      "status": "succeeded",      "channel": "cm.mtn",      "description": "Order #4172",      "sandbox": false,      "created_at": "2026-01-15T10:30:00+00:00"    }  ],  "meta": {    "current_page": 1,    "last_page": 3,    "per_page": 25,    "total": 68,    "next_cursor": "c_9fK2mQ7vB4nL6hR1xT8w",    "has_more": true  }}

Paginated list

What did you think of this content?