EVENT
webhook-debt-transferTransferencia de deuda
Configura este endpoint para recibir notificaciones cuando una deuda se transfiere a otra, ya sea por vencimiento (debt_state: DUE_DEBT) o por refinanciación (debt_state: REFINANCED).
El campo replaced_by_debt_id indica la nueva deuda que absorbe el saldo pendiente.
Configura tu endpoint en:
POST https://<tu-servidor>/debts
Si tienes dudas sobre cómo configurar un webhook, visita nuestra documentación.
Deberás respondernos un código HTTP 2xx para que no volvamos a enviar la notificación. Caso contrario, volveremos a enviarla infinitamente.
Parámetros disponibles
Header Parameters
X-Api-KeyStringrequired
X-SignatureStringrequired
X-TimestampStringrequired
X-EndpointStringrequired
Cuerpo de solicitud
application/jsonevent_idenumrequired
idempotency_keystring
typeenumrequired
idstringrequired
versioninteger
payloadobjectrequired8 propiedades
Detalle de respuestas
2XX
Respuesta exitosa por parte del cliente.
4XX
Falló la respuesta. Volveremos a enviar el evento.
5XX
Falló la respuesta. Volveremos a enviar el evento.
Ejemplo de solicitud
{
"event_id": "debt_registry",
"idempotency_key": "DUE_DEBT#debt-123#2025-02-20T00:00:00Z",
"type": "REVOLVING",
"id": "debt-123",
"version": 2,
"payload": {
"debt_id": "debt-123",
"credit_line_id": "lcr-2zkGPYwQs75zgPzcSFrCWaOQloQ",
"debt_state": "DUE_DEBT",
"replaced_by_debt_id": "debt-789",
"total_amount": "1128.45",
"transfer_date": "2025-02-20",
"transfer_details": [
{
"concept": "PRINCIPAL",
"amount": "1000.00"
},
{
"concept": "INTEREST",
"amount": "114.01"
},
{
"concept": "ADDITIONAL_INTEREST",
"amount": "0.00"
},
{
"concept": "IOF",
"amount": "14.44"
}
],
"summary": [
{
"concept": "PRINCIPAL",
"total": "1000.00",
"paid": "0.00",
"discounts": "1000.00",
"due": "0.00",
"refinanced": "0.00",
"unpaid": "0.00"
},
{
"concept": "INTEREST",
"total": "114.01",
"paid": "0.00",
"discounts": "114.01",
"due": "0.00",
"refinanced": "0.00",
"unpaid": "0.00"
},
{
"concept": "ADDITIONAL_INTEREST",
"total": "0.00",
"paid": "0.00",
"discounts": "0.00",
"due": "0.00",
"refinanced": "0.00",
"unpaid": "0.00"
},
{
"concept": "IOF",
"total": "14.44",
"paid": "0.00",
"discounts": "14.44",
"due": "0.00",
"refinanced": "0.00",
"unpaid": "0.00"
}
]
}
}