Tokenized cards (tokens) by merchant, status, token type, and date range

This feature allows merchants to query their tokenized cards, filtered by token type, status, and a date range.

Key Features

Filter by token type

The API lets you filter tokens by the following types:

• CARD

• CHECKOUT

Filter by status

You can also filter tokens by these statuses:

• VALID

• EXPIRED

This query returns all tokens generated by any user associated with the merchant.

Date range

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

Efficient pagination

The API supports paginated results using base64-encoded tokens, which allow you to safely and efficiently browse the result pages without exposing sensitive data.

Merchant validation

The system verifies that the 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 current date is used.

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

• Both status and type must exactly match the expected values. Otherwise, the API will return a 400 error.