kepa
Transaction Management/listPayments

List Payments

Every payment, every channel, one list.

GET/v1/payments
Cursor-paginated payment list spanning card-present, card-not-present and externally-acquired sales, filterable by date range, status, type, acceptance channel, card scheme, and reference ID. Ordered newest first. Use this for end-of-day reports, reconciliation screens, back-office dashboards, and dispute lookups. Supports up to 200 rows per page. This replaces the terminal-scoped transaction list, which by construction could never return an online payment.
Query parameters
cursorstring

Opaque pagination cursor from a previous response.

limitinteger

Page size, 1–200. Defaults to 50.

Example 50
fromstring · ISO 8601

Include transactions on or after this timestamp.

Example "2026-04-01T00:00:00Z"
tostring · ISO 8601

Include transactions before this timestamp.

Example "2026-04-09T00:00:00Z"
statusenum

Filter by transaction status.

APPROVEDDECLINEDCANCELLEDERRORREVERSEDPENDING_ONLINEPENDING_COMPLETION
typeenum

Filter by transaction type.

SALEPRE_AUTHPRE_AUTH_COMPLETEREFUNDVOIDCARD_READBALANCE_INQUIRY
cardSchemeenum

Filter by card scheme.

VISAMASTERCARDAMEXDISCOVERJCBUNIONPAYEFTPOSOTHER
referenceIdstring

Exact match on POS-assigned reference ID.

Example "POS-INV-20260409-001"

Response

application/json

dataarrayRequired

Array of TransactionResponse objects, newest first.

hasMorebooleanRequired

Whether more pages exist.

Example true
nextCursorstringnullable

Cursor for the next page. Null when hasMore is false.

totalCountinteger

Total matching transactions (may be approximate for large result sets).

Example 142

listPayments

GETGo API
https://api.kepapay.co/v1/payments
Request
curl https://api.kepapay.co/v1/transactions?from=2026-04-01T00:00:00Z&status=APPROVED&limit=50 \
  -H "X-Api-Key: $KEPA_SECRET_KEY"
Response
{
  "data": [
    {
      "transactionId": "txn_01JQXYZ123456",
      "status": "APPROVED",
      "type": "SALE",
      "amount": 2500,
      "currency": "NZD",
      "cardScheme": "VISA",
      "maskedPan": "************1234",
      "entryMode": "CONTACTLESS",
      "referenceId": "POS-INV-20260409-001",
      "timestamp": "2026-04-09T09:14:22Z"
    },
    {
      "transactionId": "txn_01JQXYZ123457",
      "status": "DECLINED",
      "type": "SALE",
      "amount": 5000,
      "currency": "NZD",
      "cardScheme": "MASTERCARD",
      "maskedPan": "************5678",
      "entryMode": "CONTACTLESS",
      "responseCode": "51",
      "referenceId": "POS-INV-20260409-002",
      "timestamp": "2026-04-09T09:16:05Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "cursor_txn_01JQXYZ123457",
  "totalCount": 142
}