Operations by type, status, and date range

This feature allows merchants to query historical operations filtered by a specific operation type and status, within a defined date range. It’s ideal for analytics, reporting, or transaction reconciliation.

Key Features

Filter by operation type and status

The API allows filtering by the following operation types:

• LINK

• CHECKOUT

• PAYMENT

• REFUND

• SUBSCRIPTION

• OCT

And the following statuses:

• IN_PROGRESS

• SUCCESSFUL

• FAILED

• ABANDONED

This allows you to query anything from generated payment links to processed refunds.

Date range

You can define a startDate and an endDate to narrow the query. If endDate is not provided, the system will use the current date by default (LocalDate.now()).

Efficient pagination

The API supports paginated responses using base64-encoded tokens, allowing for secure and efficient navigation without exposing sensitive data.

Merchant validation

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

• If endDate is not specified, the current date is used.

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

• Both status and type must exactly match the values expected by the API; otherwise, a 400 error will be returned.