API ReferenceTransactions
Transactions
The transaction resource : every money-moving attempt as a durable entry.
A transaction is the durable record of any money-moving attempt: recorded before validation, so failed attempts are entries too, not absences.
The transaction object
{
"id": "01M2S17G4A0N9MDMXYSCCX8SPS",
"type": "payment",
"status": "completed",
"amount_minor": 101000,
"fee_minor": 1000,
"currency": "NGN",
"customer_id": "01M2S17...",
"reference": "TRF-2026-00042",
"idempotency_key": "pay-001",
"failure": {
"code": "INSUFFICIENT_FUNDS",
"message": "Wallet balance is insufficient for this payment.",
"stage": "settlement"
},
"created_at": "2026-09-18T01:13:59Z",
"updated_at": "2026-09-18T01:14:00Z"
}| Field | Type | Notes |
|---|---|---|
type | string | payment, transfer, exchange, funding |
status | string | pending, processing, completed, failed, unknown |
failure.code | string | null | Machine-readable reason when failed |
failure.stage | string | null | Pipeline position where it stopped |