Endpoints de reporte
Listar cobros
Consulta cobros recibidos por el collector en un rango de fechas. Los datos se enriquecen del banco e incluyen trazabilidad bancaria, customer_id y estado del cobro.
GET/api/v2/paymentsReporte
Endpoint
El worker pagina internamente hasta traer todos los cobros del rango solicitado.
GET
/api/v2/paymentsdate_from y date_to son obligatorios y deben enviarse con formato yyyy-MM-ddTHH:mm:ss.
Parámetros
Parámetros soportados por el handler actual.
| Parámetro | Requerido | Notas |
|---|---|---|
| date_from | Sí | Inicio del rango. Formato: yyyy-MM-ddTHH:mm:ss. |
| date_to | Sí | Fin del rango. Formato: yyyy-MM-ddTHH:mm:ss. |
| customer_id | No | Filtra por alias o customer_id. Si no se envía, trae todos los cobros del collector. |
Valores de estado
El campo
status de cada cobro refleja el estado reportado por el banco, por ejemplo received,settlement o rejected.Ejemplos
Consultas típicas por rango de fechas y customer_id opcional.
curl -G "https://transferfix.com.ar/api/v2/payments" \
-H "X-API-Key: ck_live_12345678_abcd" \
--data-urlencode "date_from=2026-03-01T00:00:00" \
--data-urlencode "date_to=2026-03-09T23:59:59" \
--data-urlencode "customer_id=pianta.demo.0001"Respuesta
La respuesta incluye la colección completa del rango y un total agregado por el worker.
Respuesta 200
{
"success": true,
"data": {
"payments": [
{
"collection_id": "COL-2026-00142",
"collection_trace_id": "TR-00001",
"date_time": "2026-03-05T14:22:10",
"business_date": "2026-03-05",
"customer_id": "pianta.demo.0001",
"amount": 12500,
"currency_id": "ARS",
"status": "settlement",
"customer_name": "Juan Perez",
"customer_tax_id": "20123456780",
"customer_account": "0000012345678901234567",
"customer_bank_name": "Banco Galicia",
"collection_account": "0000277800000000195553"
}
],
"total": 1
}
}Paginación
La API pública no expone cursores en esta ruta. El worker pagina internamente hasta
EOF y devuelve el conjunto final en un único payload.