Skip to main content
The Transaction History endpoint returns a paginated list of your transactions, with optional filters for date range, payment status, app token, and terminal. Each row includes a settlement_status field indicating where the transaction sits in the settlement lifecycle. The endpoint has two branches selected by the type query parameter:
  • type=online (default) — returns card, wallet, and mobile-switch payments created through the online payment API.
  • type=pos — returns transactions processed by a POS terminal.

​
Query Parameters

​
integer
required
Identifier of the merchant whose history to query. The merchant must have developer API access enabled.
​
string
default:"online"
Which branch of the history to query. Either online (returns online payments — card, wallet, mobile switch) or pos (returns POS terminal transactions).
​
datetime
ISO-8601 datetime. Inclusive lower bound on the transaction creation time. Unbounded if omitted.
​
datetime
ISO-8601 datetime. Inclusive upper bound on the transaction creation time. Must be ≥ start_date and cannot be in the future.
​
string
Optional status filter. Accepts the codes in the table below for both branches — POS queries map them internally to POS payment statuses.
​
uuid
Online only. Filter results to a specific app token recorded on the payment payload.
​
string
POS only. Restrict results to a single terminal. Maximum 16 characters. Returns a 1004 validation error if combined with type=online.

​
operation_status accepted values

The endpoint accepts the same status codes regardless of type. For POS queries the code is mapped internally. Other status codes are passed through verbatim with no automatic mapping.

​
Validation errors

​
Response

The endpoint returns a paginated list. Each element is shaped according to the requested type.
​
string
required
Payment method used. One of card, flouci (wallet), mpayment (mobile switch), or NA.
​
integer
required
Amount in millimes.
​
string
required
Payment status. One of SUCCESS, PENDING, EXPIRED, FAILURE, PREAUTH_SUCCESS, or SYSTEM_FAILURE.
​
object
Buyer information. Shape depends on the payment type.
​
string
Your merchant-supplied reference. May be null.
​
integer
Per-transaction fee in millimes. Returns an empty string "" until the fee has been computed.
​
integer
VAT in millimes. Returns an empty string "" until computed.
​
string
required
Settlement lifecycle state for this transaction. See Settlement Status.

​
Examples

There is currently no query parameter to filter by settlement_status. To separate transactions by settlement state — for example, to identify what has already been wired to your bank versus what is still in flight — filter the returned list client-side on the settlement_status field.