Pagos
Buscar pagos
Lista los pagos de la cuenta creados en una ventana de hasta 1 día, con filtros y paginación por cursor.
GET
Buscar pagos
Esta solicitud lista los pagos de la cuenta enviada en el header
X-Account-Code. Úsala para sincronizar pagos con un data warehouse o para construir un panel de administración. Para consultar un solo pago, usa Obtener pago por ID u Obtener pago por ID de orden del comercio.
Ventana de creación
created_at_from y created_at_to son fechas y horas obligatorias en formato RFC 3339 con desplazamiento de zona horaria, por ejemplo 2026-11-03T00:00:00Z o 2026-11-03T00:00:00-03:00. created_at_from es inclusiva y created_at_to es exclusiva, así que dos ventanas consecutivas que comparten un límite no se superponen. created_at_to debe ser posterior a created_at_from, y la ventana entre ambas es de hasta 1 día (24 horas). Una ventana más amplia responde 400 DATE_RANGE_TOO_WIDE. Para cubrir un período más largo, envía una solicitud por cada ventana de 24 horas, por ejemplo días UTC consecutivos.
Filtros
Todos los filtros son opcionales y se combinan con AND:
Envía cada parámetro una sola vez, salvo
status. Un parámetro que no aparece en esta página, o un filtro con un valor inválido, responde 400 INVALID_PARAMETERS.
Paginación
Las filas se ordenan porcreated_at ascendente. limit define el tamaño de la página, de 1 a 100, y por defecto es 50.
La respuesta es un objeto con tres campos:
Para leer la página siguiente, envía
cursor con el valor de next_cursor sin modificar, junto con el mismo X-Account-Code y los mismos filtros de la solicitud que lo devolvió. Sigue paginando hasta que has_more sea false. Un cursor modificado, o enviado con otra cuenta u otros filtros, responde 400 INVALID_CURSOR. La paginación solo avanza.
Filas
Cada fila es un resumen del pago:id, account_id, merchant_order_id, description, country, status, sub_status, amount.value, amount.currency, payment_method.type, customer_payer.id, created_at y updated_at.
Las filas no incluyen el arreglo
transactions. Obtén el pago por su id para recibir el objeto de pago completo.Errores
Los errores usan el envoltorio concode y messages.
Autorizaciones
Parámetros de consulta
Estados de pago a buscar. Envía una lista separada por coma (status=SUCCEEDED,DECLINED) o repite el parámetro (status=SUCCEEDED&status=DECLINED).
Opciones disponibles:
CREATED, READY_TO_PAY, PENDING, SUCCEEDED, VERIFIED, DECLINED, REJECTED, ERROR, EXPIRED, CANCELED, REFUNDED, IN_DISPUTE, CHARGEBACK Respuesta
200