Skip to main content
El módulo de Cobros permite procesar múltiples transacciones recurrentes en un solo envío mediante la carga de un archivo. Cada cobro se ejecuta contra una afiliación previamente registrada.

Operaciones disponibles

Carga de cobros

Envía un archivo con las operaciones a cobrar. Cada fila referencia una afiliación activa y el monto a procesar.

Reporte de cobros

Descarga el reporte con el resultado detallado de cada cobro procesado — exitosos, rechazados y pendientes.

Flujo de un cobro recurrente

1

Prepara el archivo de cobros

Genera el archivo con las operaciones a procesar. Cada fila debe incluir el identificador de afiliación y el monto en centavos.
2

Carga el archivo

Envía el archivo al endpoint de carga de cobros. El sistema lo procesa en modo batch de forma asíncrona.
3

Consulta el reporte

Una vez procesado, descarga el reporte de resultados para verificar el estado de cada operación y reconciliar con tu sistema.

Consideraciones

Los cobros se procesan en modo batch asíncrono. El resultado no es inmediato — usa el reporte de cobros para verificar el estado de cada operación.
Solo se pueden procesar cobros contra afiliaciones en estado activo. Verifica el estado de cada afiliación antes de incluirla en el archivo.
Los montos deben expresarse en centavos. Ejemplo: S/. 10.50 → "1050".

Referencia técnica

La especificación completa — estructura del archivo de carga, parámetros, formato del reporte y ejemplos — está publicada en GitHub.

Ver referencia en GitHub

Carga de cobros · Reporte de resultados · Ejemplos

Siguiente paso

Códigos de Respuesta

Consulta los códigos de respuesta específicos del módulo de Pagos Recurrentes.