Cómo funciona

El débito automático tiene dos pasos: afiliar a la persona con su cuenta y, después, enviarle los cobros.

1. Afilia a la persona

Envía Affiliation con el documento de la persona o empresa y su cuenta.

Cada registro es una persona o empresa (DNI, CE o RUC) con una cuenta. En un mismo envío puedes mandar muchas.

Cada persona tiene una sola cuenta afiliada, así que envía un registro por persona. En details ves el resultado de cada uno.

Kambia envía la afiliación al banco, y queda pendiente hasta que el banco la acepta.

2. Envía los cobros

Envía Charge con el document_number y el monto.

Usa el mismo document_number con el que afiliaste: con él se ubica la afiliación y se debita la cuenta afiliada.

Si envías un cobro antes de que el banco acepte la afiliación, queda guardado y sale solo cuando la afiliación esté lista. La respuesta te lo avisa en not_ready_to_send.

Si repites a una persona en el mismo envío, vuelve en duplicates. Si la reenvías con confirm: true e idempotency_key, los montos se suman en un solo cobro.

Cambiar la cuenta

Si la afiliación ya fue aceptada, envía Affiliation otra vez con la cuenta nueva. Hasta que el banco acepte el cambio, se sigue debitando la cuenta anterior.

Autorización del titular

Antes de afiliar a una persona necesitas su autorización previa, expresa y por escrito para el débito automático. Kambia no la genera ni la recibe por la API: la obtienes y la guardas tú, y la presentas cuando el banco, una autoridad o Kambia te la pidan.

Puedes incluir esta cláusula en tus contratos:

CLÁUSULA [NÚMERO]: Débito Automático.-
EL (LA) PRESTATARIO(A) autoriza de manera expresa a [NOMBRE DE LA ENTIDAD], directamente o a través de los proveedores tecnológicos, operadores de cobro y/o empresas especializadas que contrate para tal efecto —incluyendo a KAMBIA S.A.C.—, a efectuar, en caso de mora, el débito automático de los montos vencidos, intereses moratorios y demás cargos generados por la mora, conforme al presente contrato, con cargo a sus cuentas en el Banco de Crédito del Perú (BCP) y en cualesquiera otras entidades del sistema financiero, así como a billeteras digitales y demás medios legales de pago o almacenamiento de dinero de los cuales sea titular, respetando los límites de protección de remuneraciones y fondos inembargables previstos por ley. Por cada débito ejecutado asumirá un cargo fijo de S/ 20.00 (veinte con 00/100 soles) por concepto de gestión operativa. Esta autorización se mantiene vigente hasta el cumplimiento total de las obligaciones del presente contrato, salvo comunicación escrita en contrario. Los garantes que suscriban el presente contrato otorgan esta misma autorización respecto de sus cuentas y medios de pago, hasta la cancelación total de la obligación garantizada.

Si la persona ya firmó su contrato sin esta cláusula, usa el modelo de autorización.

Pruebas en sandbox

Usa tus mismas credenciales con https://sandbox.kambia.app/v1.

En sandbox nada llega al banco: la afiliación se queda pendiente, así que tus cobros de prueba vuelven en not_ready_to_send. Es lo esperado.

1. Afilia a la persona#

2. Envía los cobros#

Cambiar la cuenta#

Autorización del titular#

Pruebas en sandbox#

1. Afilia a la persona

2. Envía los cobros

Cambiar la cuenta

Autorización del titular

Pruebas en sandbox