Authorization
default 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
Max results per page (1–100).
The page to read, from 1, for offset pagination. Ignored with `cursor`.
Filter by status. One of: `pending`, `processing`, `succeeded`, `failed`, `cancelled`. Before API version 2026-10-12, `failed` also returns the cancelled refunds, which that version reads as `failed`.
"pending""processing""succeeded""failed""cancelled"The `next_cursor` of a previous response, a numbered page included: switches the list to cursor pagination.
Refunds created on or after this date, `YYYY-MM-DD`.
Refunds created on or before this date, on or after `date_from`.
Search over the refund `id` and your reference.
Response Body
application/json
application/json
curl -X GET "https://api.wajub.com/refunds?per_page=10&page=2&status=failed&date_from=2026-09-01&date_to=2026-09-30"{ "code": 200, "status": "OK", "message": "Refunds retrieved", "items": [ { "id": "rfd_Pm3Vc8Lx2Nq7Rb5Tk9Hw", "transaction": "trx_CSUGajfv9xh0XQ5wu2lx", "reference": "refund-ord-1042", "amount": 5000, "currency": "XAF", "fees_bearer": "merchant", "fee_amount": 100, "payer_amount": 5000, "status": "succeeded", "execution_mode": "automatic", "reason": "requested_by_customer", "metadata": {}, "ledger_balance_currency": "XAF", "ledger_balance_before": 85000, "ledger_balance_after": 80000, "sandbox": false, "created_at": "2026-09-18T09:30:12+00:00", "updated_at": "2026-09-18T09:31:02+00:00" } ], "meta": { "current_page": 1, "last_page": 1, "per_page": 25, "total": 1, "next_cursor": null, "has_more": false }}OK