Transactions by merchant and date range

This feature allows merchants to query transactions within a specific date range.

Key Features

Transaction types returned

This query only returns transactions of the following types:

• PAYMENT

• REFUND

• OCT (Original Credit Transfer)

Only these types of operations will be included in the response.

Filter by merchant and date range

The API allows filtering transactions using date values in the following format:

• 2025-06-14T00:00:00Z

• 2025-06-19T00:00:00Z

This lets you retrieve all transactions performed by the merchant within the selected time period.

Date range

You can specify a startDate and an endDate to limit the query. If endDate is not provided, the system will use the current date and time by default (OffsetDateTime.now()).

Efficient pagination

The API returns results in pages using base64-encoded tokens. This enables safe and efficient navigation without exposing sensitive data.

Merchant validation

The system checks that the provided merchantId belongs to a valid and authorized merchant. If the ID is invalid, the request will return an HTTP 400 error with a clear message.

Notes

• If endDate is not provided, the system will use the current date.

• If a paginationToken is included, the startDate will be ignored on the next page request.