Tarjetas tokenizadas (Tokens) por comercio, estado, tipo y rango de fecha

Esta funcionalidad permite a los comercios consultar sus tarjetas tokenizadas, filtradas por tipo de token, estado, y un rango de fechas

---

🧾 Características principales

Filtro por tipo de token

La API permite filtrar los tokens por los siguientes tipos:

• CARD

• CHECKOUT

Por los siguientes estados:

• VALID

• EXPIRED

Esto permite consultar los tokens generados por todos los usuarios de un comercio

Rango de fechas

El usuario puede definir un rango de fechas (startDate, endDate) para acotar la consulta. Si no se especifica el endDate, se tomará como valor por defecto la fecha actual (LocalDate.now()).

Paginación eficiente

El sistema soporta respuesta paginada usando tokens codificados en base64, lo cual permite navegar los resultados de forma segura y eficiente sin exponer información sensible.

Validación de comercio relacionado

El sistema valida que el merchantId corresponda a un comercio existente y autorizado, rechazando peticiones con IDs inválidos mediante una respuesta HTTP 400 con un mensaje claro.

Consideraciones

• Si no se especifica endDate, se utiliza la fecha actual.

• Si paginationTokens está presente, se ignora el parámetro startDate en la página siguiente.

• El status y type deben coincidir exactamente con los valores esperados por la API o se lanzará un error 400.