KashierDevelopersKashier Developers
API reference and playgroundInstant settlement

Get request transactions

curl -X GET "https://test-api.kashier.io/v3/payment/instant-settlements/instant-requests/string/transactions"
{  "message": "success",  "data": [    {      "transactionId": "TX-1001",      "settlementAmount": 10000,      "accountId": "ACC-39550-436-01",      "rfsDate": "2026-06-15T00:00:00.000Z",      "method": "card",      "selected": true,      "unselectedAt": null    },    {      "transactionId": "TX-1002",      "settlementAmount": 5000,      "accountId": "ACC-39550-436-02",      "rfsDate": "2026-06-16T00:00:00.000Z",      "method": "wallet",      "selected": true,      "unselectedAt": null    }  ],  "pagination": {    "total": 2,    "limit": 20,    "page": 1,    "pages": 1  },  "summary": {    "count": 2,    "totalAmount": 15000,    "totalSettlementAmount": 15000  },  "selectionSummary": {    "selectedCount": 2,    "unselectedCount": 0,    "selectedSettlementAmount": 15000,    "unselectedSettlementAmount": 0  }}

Returns the transactions that belong to a specific request, paginated. Rows an agent removed from the request stay on it and come back with selected: false and an unselectedAt timestamp; use the selection filter to narrow the list to one side.

selectionSummary spans the whole request and ignores the selection filter, so a single call is enough to render both a "selected" and an "unselected" count. summary keeps its usual meaning: totals for the current filter across all pages.

Requires the instant_settlement_request feature flag and the instant_settlements.all.view_instant_settlement permission.

Authorization

secretKey
Authorization<token>

Merchant secret key used to identify the merchant, obtained from Kashier's dashboard. Pass the raw secret key value in the Authorization header (NOT a "Bearer" token).

In: header

Path Parameters

id*string

The request's UUID id or its human-readable requestId (for example ISR-1042).

Query Parameters

page?integer

1-based page number.

Default1
limit?integer

Records per page.

Default20
selection?string

Which rows to return: ALL (default) for both, SELECTED for rows still in the request, UNSELECTED for rows an agent removed. Any other value is rejected with 400.

Default"ALL"

Value in

  • "ALL"
  • "SELECTED"
  • "UNSELECTED"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

GET
/v3/payment/instant-settlements/instant-requests/{id}/transactions

Get request details GET

Returns the full detail of a single instant settlement request: its totals and fee breakdown, its status history, the transactions an agent excluded from it, and the balance-ledger records created…

Send a message to a POS terminal POST

Relays a JSON message to one of your POS terminals. Kashier authenticates you as the merchant, confirms the terminal belongs to your account, and forwards the message to the terminal in real time o…