List transactions

Page through your transactions in reverse-chronological order. Useful for backfilling, reconciliation, and admin tooling. For real-time payment state, use webhooks.

GET/v1/payments

Query parameters

Parameters

status

string

Filter by status. One of PENDING, PROCESSING, SUCCESS, FAILED, CANCELLED, REFUNDED.

take

integer

Page size. Maximum 200. Defaults to 50.

cursor

string

The id of the last transaction returned. Pass to fetch the next page.

Sample request

cURL

curl "https://api.jkapay.com/v1/payments?status=SUCCESS&take=100" \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "X-JKAPay-Merchant-Id: MCH_XXXXXXXXXXXX"

Response200

JSON

{
  "transactions": [
    {
      "reference": "JKA_M3A8_8F2E1B4C",
      "clientReference": "ORD-12345",
      "status": "SUCCESS",
      "type": "COLLECTION",
      "amount": "1.00",
      "fee": "0.02",
      "net": "0.98",
      "currency": "GHS",
      "customer": {
        "msisdn": "233244000000",
        "name": "AMOAH JOHNSON",
        "email": null,
        "network": "MTN"
      },
      "description": "Order #12345",
      "failureReason": null,
      "metadata": { "orderId": "12345" },
      "initiatedAt": "2026-05-25T16:30:00.000Z",
      "completedAt": "2026-05-25T16:30:18.213Z"
    }
  ]
}