1. Débito automático
API
Español
  • Español
  • English
  • Introducción
    • API Kambia
    • Credenciales
    • Autenticación
    • Verificación
      POST
  • Servicios
    • Catálogo de códigos
    • Payout
      • Notificaciones
      • Create payout
      • Get payout
    • Débito automático
      • Cómo funciona
      • Modelo de autorización
      • Notificaciones
      • Affiliation
        POST
      • Charge
        POST
  1. Débito automático

Charge

Developing
POST
/{{api_version}}/autodebit/{{merchant_id}}/charge
Descripción
Genera órdenes de cobranza de los clientes afiliados
Autenticación
Revisa la sección aquí
Duplicados y confirmación
Si el mismo documento se repite en el envío, ya tiene un cobro pendiente de otro envío de hoy o ya tiene una orden de cobro activa en el banco (dentro de su ventana de reintento), el registro no se guarda: aparece en duplicates (respuesta 207). Para forzarlo, reenvíalo con confirm: true y una idempotency_key:
Si ya tenía un cobro pendiente de hoy, indica también resolution: sum si es otra deuda (se suma al pendiente) o replace si corrige un envío anterior (reemplaza el pendiente). Con replace, envía además expected_previous_amount con el previous_amount que te devolvimos. Sin resolution, el registro vuelve a duplicates.
Si solo tenía una orden activa en el banco, basta con confirm: true: no se suma nada.
Reenviar la misma confirmación con la misma idempotency_key es seguro: no vuelve a sumar el monto.
Un cobro pendiente de un día anterior no cuenta como duplicado: el envío de hoy lo reemplaza.
Avisos que no frenan el cobro
not_ready_to_send: cobros guardados que hoy no entrarían al archivo del banco por el estado de la afiliación, con el motivo.
recently_charged: personas a las que el banco ya les cobró en los últimos 7 días, con la fecha y el monto de ese cobro. El cobro nuevo sale igual; revisa si es el mismo.

Request

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted
application/json
Bodyapplication/json

🟢207Possible duplicate or error
Response Response Example
202 - Accepted
{
    "status_code": 202,
    "message": "Charge record(s) processed successfully",
    "data": {
        "processed": 2,
        "total": 2,
        "duplicates": [],
        "not_ready_to_send": [],
        "recently_charged": [],
        "warnings": []
    }
}
Modified at 2026-10-02 17:40:03
Previous
Affiliation
Built with