Operations by merchant and date range

This feature allows merchants to retrieve historical operations within a defined date range. It's ideal for getting general metrics, as the response includes everything the merchant has done.

Key Features

Filter by merchant and date range

The API lets you filter operations using the following date format:

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

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

This means you can query all operations performed by a merchant within the specified time range.

Date range

You can define a start and end date (startDate, endDate) to narrow down the search. If endDate is not provided, the current date and time (OffsetDateTime.now()) will be used by default.

Efficient pagination

The system returns paginated results using base64-encoded tokens. This allows for safe and efficient navigation through pages, without exposing sensitive information.

Merchant validation

The system checks that the provided merchantId belongs to a valid and authorized merchant. Requests with invalid IDs are rejected with an HTTP 400 response and a clear error message.

Notes

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

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