Conciliar tus cobros: reportes, rendiciones y saldos

Con los reportes diarios de la API de PAGOS360 conciliás desde tu sistema: cruzás tus registros con los movimientos de PAGOS360. Cada día ves lo que cobraste, lo que se revirtió o devolvió, lo que te retuvieron por impuestos y lo que efectivamente se te rindió (tus retiros de fondos ya ejecutados).

En esta guía vas a ver qué contiene cada reporte, cuándo usarlo y una rutina diaria recomendada para cerrar el día.

Antes de empezar

Entorno	URL base
Sandbox	`https://api.sandbox.pagos360.com`
Producción	`https://api.pagos360.com`

Todas las peticiones llevan tu API Key como Bearer token:

curl 'https://api.sandbox.pagos360.com/account/balances' \ -H 'Authorization: Bearer <API Key>'

Cada entorno tiene su propia API Key. Más información en Autorización y Entornos.

La clave de la conciliación: `external_reference`

Cuando creás una solicitud de pago, una adhesión o un débito, le asignás una external_reference (tu ID de cliente, de factura, de venta, etc.). Los reportes devuelven esa misma external_reference en cada movimiento, junto al request_id de PAGOS360.

Tip

Guardá siempre en tu sistema el par external_reference + request_id. La external_reference te dice a qué deuda o cliente corresponde el movimiento y el request_id lo identifica de forma única del lado de PAGOS360.

En los débitos automáticos (por CBU o tarjeta), la external_reference que viene en los reportes de reversiones y devoluciones es la de la adhesión, no la de cada débito.

Los reportes

Todos los reportes son GET, reciben la fecha en el path y devuelven un JSON con cabecera (account_id, report_date y totales) y un arreglo data con el detalle.

Reporte	Endpoint	Qué contiene	Cuándo usarlo
Cobros	`GET /report/collection/{date}`	Pagos informados ese día, con comisión, IVA, retenciones, neto y fecha de disponibilidad.	Imputar pagos en tu sistema (marcar facturas o cuotas como cobradas).
Reversiones	`GET /report/chargeback/{date}`	Cobros revertidos informados ese día (por ejemplo, desconocimientos o contracargos).	Revertir la imputación de un pago ya registrado.
Devoluciones	`GET /report/refund/{date}`	Cobros devueltos al pagador informados ese día.	Reflejar devoluciones en tu sistema.
Rendiciones	`GET /report/settlement/{date}`	Créditos y débitos incluidos en la rendición de ese día y el importe total rendido.	Conciliar contra lo que efectivamente se acreditó.
Retenciones y percepciones	`GET /report/retentions/{date}`	Retenciones y percepciones impositivas informadas ese día, con base imponible, alícuota y jurisdicción.	Registración contable e impositiva.

Formato de fecha

La fecha va en el path con formato dd-mm-aaaa, por ejemplo /report/collection/15-09-2026.
Los reportes de cobros, reversiones, devoluciones y retenciones solo aceptan días cerrados, es decir, fechas anteriores a hoy. Si pedís la fecha de hoy o una futura, la API responde 400.
El reporte de rendiciones acepta cualquier fecha válida, incluida la de hoy. Solo devuelve rendiciones ya efectuadas.
Las fechas de la respuesta vienen en ISO-8601 con zona horaria, por ejemplo 2026-09-15T00:00:00-03:00.

Importante

Para conciliar un pago, usá siempre el reporte del día en que se informó. El reporte de cobros agrupa los pagos por fecha en la que se informaron a PAGOS360 (informed_date), no por la fecha en que pagó el cliente (payment_date). En algunos medios de pago (por ejemplo, los de pago en efectivo), un pago hecho un viernes puede informarse el lunes.

Cobros

curl 'https://api.sandbox.pagos360.com/report/collection/15-09-2026' \ -H 'Authorization: Bearer <API Key>'

{ "account_id": "ABC12345", "report_date": "2026-09-15T00:00:00-03:00", "total_collected": 10000.00, "total_gross_fee": 605.00, "total_net_amount": 9395.00, "total_retentions": null, "data": [ { "informed_date": "2026-09-15T10:12:30-03:00", "request_id": 123456, "external_reference": "factura-0001", "payer_name": "Juan Perez", "description": "Cuota septiembre", "payment_date": "2026-09-15T10:10:02-03:00", "retentions": null, "channel": "DEBIN", "amount_paid": 10000.00, "net_fee": 500.00, "iva_fee": 105.00, "net_amount": 9395.00, "available_at": "2026-09-16T00:00:00-03:00" } ] }

net_amount = amount_paid − net_fee − iva_fee − retentions.
available_at indica cuándo ese importe pasa a estar disponible en tu cuenta.
retentions y total_retentions vienen en null cuando no hubo retenciones.
Si no hubo cobros, la respuesta trae los totales en 0 y data vacío.

Referencia: Consultar cobros.

Reversiones y devoluciones

Los dos reportes tienen la misma estructura. Solo cambian los nombres del total y del importe de cada fila:

Reporte	Total	Importe por fila
Reversiones	`total_chargeback`	`reverted_amount`
Devoluciones	`total_refunded`	`refunded_amount`

Cada fila trae informed_date, request_id, external_reference, payer_name, description, channel y available_at.

{ "account_id": "ABC12345", "report_date": "2026-09-15T00:00:00-03:00", "total_refunded": 2500.00, "data": [ { "informed_date": "2026-09-15T16:40:00-03:00", "request_id": 123400, "external_reference": "factura-0002", "payer_name": "Maria Gomez", "description": "Cuota agosto", "channel": "Visa Credito", "refunded_amount": 2500.00, "available_at": "2026-09-15T16:40:00-03:00" } ] }

Referencias: Consultar reversiones y Consultar devoluciones.

Rendiciones

Una rendición es un retiro de fondos de tu cuenta PAGOS360 ya ejecutado. El reporte muestra qué movimientos la componen.

curl 'https://api.sandbox.pagos360.com/report/settlement/16-09-2026' \ -H 'Authorization: Bearer <API Key>'

{ "account_id": "ABC12345", "report_date": "2026-09-16T09:00:00-03:00", "total_credits": 1, "credit_amount": 9395.00, "total_debits": 0, "debit_amount": 0, "settlement_amount": 9395.00, "data": [ { "request_id": 123456, "external_reference": "factura-0001", "credit": 9395.00, "debit": 0 } ] }

total_credits y total_debits son cantidades de movimientos. credit_amount y debit_amount son importes.
settlement_amount es el importe total rendido.
Solo se informan rendiciones efectuadas. Si no hubo rendición ese día, los totales vienen en 0 y data vacío.

Referencia: Consultar rendiciones.

Retenciones y percepciones

Las retenciones y percepciones son importes a cuenta de impuestos que se descuentan de tus cobros. Este reporte te da el detalle de cada una para tu registración contable e impositiva.

{ "account_id": "ABC12345", "report_date": "2026-09-15T00:00:00-03:00", "total_amount": 20.00, "data": [ { "created_at": "2026-09-15T10:12:30-03:00", "request_id": 123456, "external_reference": "factura-0001", "type": "Ganancias", "jurisdiction": "Nacional", "channel": "DEBIN", "tax_base": 1000.00, "aliquot": "2%", "exclusion_percentage": null, "amount": 20.00, "certificate_id": 0 } ] }

Referencia: Consultar retenciones y percepciones impositivas.

Saldos de tu cuenta

GET /account/balances devuelve el estado actual de tu cuenta PAGOS360:

curl 'https://api.sandbox.pagos360.com/account/balances' \ -H 'Authorization: Bearer <API Key>'

{ "user_account_id": "ABC12345", "available_balance": 11900.84, "unavailable_balance": 0 }

Campo	Descripción
`user_account_id`	ID de tu cuenta PAGOS360 (el mismo que `account_id` en los reportes).
`available_balance`	Fondos disponibles.
`unavailable_balance`	Fondos pendientes de acreditación.

Es una foto del momento de la consulta, no un histórico.

Referencia: Consultar fondos.

Rutina diaria recomendada

Programá un proceso que corra cada mañana y procese el día anterior (D-1):

Cobros: pedí GET /report/collection/{D-1}. Por cada fila, buscá en tu sistema la external_reference y marcá la deuda como cobrada. Guardá request_id, amount_paid, net_amount y available_at.
Reversiones y devoluciones: pedí GET /report/chargeback/{D-1} y GET /report/refund/{D-1}. Revertí las imputaciones que correspondan y buscá por request_id el cobro original.
Retenciones: pedí GET /report/retentions/{D-1} y registrá cada retención o percepción asociada al request_id.
Rendición: pedí GET /report/settlement/{hoy} (o del día de la rendición). Verificá que settlement_amount coincida con el crédito en tu cuenta bancaria y que cada request_id rendido esté imputado en tu sistema.
Saldo: consultá GET /account/balances y guardalo como control. Te ayuda a detectar diferencias antes de que se acumulen.
Controles cruzados:
- Verificá que la suma de net_amount del reporte de cobros coincida con total_net_amount.
- Verificá que los cobros que todavía no aparecen en una rendición tengan un available_at futuro o estén reflejados en unavailable_balance.
- Si un request_id no tiene external_reference en tu sistema, marcalo para revisión manual.

Tip

Hacé la rutina idempotente: guardá qué fechas ya procesaste y usá el request_id como clave única. Así podés reprocesar un día sin duplicar imputaciones.

Importante

Si recibís un reporte vacío en un día en que esperabas movimientos, reintentá más tarde antes de darlo por cerrado. Los reportes de un día cerrado se generan a partir de un proceso de cierre: si lo pedís muy temprano, puede venir vacío o incompleto.

Errores

Código	Cuándo	Cuerpo
`400`	Fecha con formato inválido, inexistente o no permitida (hoy o futura en los reportes de día cerrado).	`{"status_code": 400, "message": "El formato de fecha debe ser dd-mm-aaaa."}`
`404`	No se pudo obtener el saldo (`/account/balances`).	`{"status_code": 404, "message": "Resource not found"}`
`409`	Error inesperado al generar el reporte. Reintentá más tarde.	`{"status_code": 409, "message": "Conflict"}`

Si usás Alias de pago

Los cobros recibidos por Alias de pago (CVU) se consultan y reportan en su propia API (https://api-pct.pagos360.com/v1, con header X-API-Key). Ahí tenés el listado de cobros filtrable por external_reference del alias, las liquidaciones y los reportes asincrónicos COLLECTIONS y SETTLEMENT en CSV o XLSX. Mirá Recaudar con Alias de pago y Reportes de Alias de pago.

Última actualización el