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

Affiliation

Developing
POST
/{{api_version}}/autodebit/{{merchant_id}}/affiliation
Descripción
Afilia clientes al servicio de débito automático para su posterior cobranza
Autenticación
Revisa la sección aquí
Resultado por registro
Cada registro vuelve en details con su resultado: nueva, actualizada, agregada, quitada, rechazada (con el motivo) o error (no se pudo guardar; vuelve a enviarlo). reason explica cuando la cuenta queda guardada sin cambiar la de cobro, o cuando quitaste la de cobro. Si algún registro terminó en error, la respuesta es 207.
Varias cuentas por persona
Campo opcional account_action en cada registro: replace (la cuenta pasa a ser la de cobro), add (se suma sin reemplazar la de cobro; es lo mismo que add_account: true) o remove (se quita; si era la de cobro, no se le cobra hasta que elijas otra). Sin el campo, una cuenta nueva del mismo banco reemplaza a la de cobro, como siempre. Hasta 10 cuentas por persona. Ver Cómo funciona.

Request

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted
application/json
Bodyapplication/json

Response Response Example
{
    "status_code": 202,
    "message": "Affiliate record(s) processed successfully",
    "data": {
        "processed": 2,
        "rejected": 0,
        "total": 2,
        "details": [
            {
                "document_number": "12345678",
                "full_name": "Juan Perez",
                "outcome": "nueva"
            },
            {
                "document_number": "20123456789",
                "full_name": "Empresa SAC",
                "outcome": "nueva"
            }
        ]
    }
}
Modified at 2026-10-06 06:51:13
Previous
Notificaciones
Next
Charge
Built with