v50

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-0342108400.9 KB
Transactions

List transactions

Lists detailed history of all transactions associated with the merchant profile.

get/v2.1/merchants/{merchant_code}/transactions/history

Path parameters

merchant_codestring required
Example:MH4H92C7

Merchant code of the account whose transaction history should be listed.

Query parameters

transaction_codestring

Retrieves the transaction resource with the specified transaction code.

order'ascending' | 'descending'

Specifies the order in which the returned results are displayed.

limitinteger

Specifies the maximum number of results per page. Value must be a positive integer and if not specified, will return 10 results.

users[]string[]

Filters the returned results by user email.

[
  "merchant@example.com"
]
statuses[]string[]

Filters the returned results by the specified list of final statuses of the transactions.

payment_types[]PaymentType[]

Filters the returned results by the specified list of payment types used for the transactions.

entry_modes[]EntryMode[]

Filters the returned results by the specified list of entry modes.

types[]string[]

Filters the returned results by the specified list of transaction types.

changes_sincestring date-time

Filters the results by the latest modification time of resources and returns only transactions that are modified at or after the specified timestamp (in ISO8601 format).

newest_timestring date-time

Filters the results by the creation time of resources and returns only transactions that are created before the specified timestamp (in ISO8601 format).

newest_refstring

Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are smaller than the specified value. This parameters supersedes the newest_time parameter (if both are provided in the request).

oldest_timestring date-time

Filters the results by the creation time of resources and returns only transactions that are created at or after the specified timestamp (in ISO8601 format).

oldest_refstring

Filters the results by the reference ID of transaction events and returns only transactions with events whose IDs are greater than the specified value. This parameters supersedes the oldest_time parameter (if both are provided in the request).

Response

Returns a page of transaction history items.

Example response

{
  "items": [
    {
      "transaction_code": "TEENSK4W2K",
      "amount": 10.1,
      "currency": "EUR",
      "timestamp": "2020-02-29T10:56:56.876Z",
      "status": "SUCCESSFUL",
      "payment_type": "ECOM",
      "installments_count": 1,
      "merchant_code": "MH4H92C7",
      "transaction_id": "410fc44a-5956-44e1-b5cc-19c6f8d727a4",
      "user": "merchant@example.com",
      "type": "PAYMENT",
      "payout_date": "2019-08-28",
      "payout_type": "BANK_ACCOUNT",
      "refunded_amount": 0
    }
  ],
  "links": []
}