Operaciones por tipo, estado y rango de fechas

Esta funcionalidad permite a los comercios consultar operaciones históricas asociadas a un tipo específico de operación y un estado determinado, dentro de un rango de fechas definido. Es ideal para procesos de análisis, reportes o conciliación de transacciones.

---

🧾 Características principales

Filtro por tipo y estado de operación

La API permite filtrar operaciones por los siguientes tipos:

• LINK

• CHECKOUT

• PAYMENT

• REFUND

• SUBSCRIPTION

• OCT

Y por los siguientes estados:

• IN_PROGRESS

• SUCCESSFUL

• FAILED

• ABANDONED

Esto permite consultar desde enlaces de pago generados hasta reembolsos procesados.

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.