Aceleración de deuda
Permite que tus clientes anticipen el pago de sus planes de cuotas vigentes antes del vencimiento.
Introducción
Cuando el titular de una línea de crédito quiere adelantarse y pagar parte o toda la deuda pendiente antes del vencimiento, puedes ofrecerle la aceleración de deuda. Esta funcionalidad te permite consultar cuánto cuesta anticipar uno o más planes de cuotas y, luego, confirmar la operación.
transaction_id (ctx). Al acelerar un ctx, anticipa todas las cuotas restantes de ese plan.
Alcance
El contenido de este artículo aplica únicamente para 🇧🇷Brasil.
Funcionamiento
El flujo tiene siempre dos pasos obligatorios:
- Simular: consulta el valor a pagar por la anticipación, sin ejecutar ninguna operación.
- Confirmar: ejecuta la aceleración para los mismos
transaction_idsusados en la simulación.
due_date).
Veamos en detalle cada uno de los pasos:
Paso 1 — Simular la aceleración
GET /lending/v1/credit-lines/{credit_line_id}/debt/simulation
Indica los transaction_ids (ctx) de los planes que quieres anticipar como query params. La simulación no ejecuta la anticipación — solo retorna el costo.
Parámetros
| Parámetro | Tipo | Ubicación | Obligatorio | Descripción |
|---|---|---|---|---|
| credit_line_id | String | path | Sí | ID de la línea de crédito. |
| transaction_ids | String | query | No | IDs de los planes (ctx) a anticipar, separados por coma. |
Respuesta (200)
| Campo | Descripción |
|---|---|
| total | Saldo total de la línea de crédito. |
| current | Valor corriente de los planes seleccionados. |
| acceleration | Valor que cobramos en la factura para realizar la anticipación. |
| has_pending_operations | Indica si hay operaciones pendientes que pueden afectar el cálculo. |
| installments | Detalle de cada cuota restante de los planes seleccionados: número, valor y due_date. |
Códigos de error
| Código HTTP | error_code | Motivo |
|---|---|---|
| 400 | BAD_REQUEST | transaction_ids con formato inválido o no separados por coma. |
| 422 | TRANSACTION_NOT_REGISTERED | Alguno de los ctx enviados no está registrado en deuda. |
| 500 | INTERNAL_SERVER_ERROR | Error interno inesperado. |
Ejemplo de request
Ejemplo de respuesta
Paso 2 — Confirmar la aceleración
POST /lending/v1/credit-lines/{credit_line_id}/debt/acceleration
Una vez que el usuario acepta los valores simulados, confirma la operación pasando los mismos transaction_ids en el body. El campo transaction_ids es obligatorio — envía todos los ctx que quieras acelerar.
Parámetros
| Parámetro | Tipo | Ubicación | Obligatorio | Descripción |
|---|---|---|---|---|
| credit_line_id | String | path | Sí | ID de la línea de crédito. |
| transaction_ids | Array | body | Sí | IDs de los planes (ctx) a anticipar. |
Códigos de error
| Código HTTP | error_code | Motivo |
|---|---|---|
| 400 | BAD_REQUEST | transaction_ids con formato inválido. |
| 422 | TRANSACTION_NOT_REGISTERED | Alguno de los ctx enviados no está registrado en deuda. |
| 500 | INTERNAL_SERVER_ERROR | Error interno inesperado. |
Ejemplo de request
Aceleración parcial o total
Puedes pasar un subconjunto de los ctx vigentes para acelerar solo algunos planes, o pasar todos los ctx para acelerar la deuda completa. El campo transaction_ids es siempre obligatorio.
Vigencia de la simulación
La simulación expira a las 00:00h del día. Después de ese horario, necesitas llamar de nuevo al GET /debt/simulation para obtener un nuevo cálculo actualizado.
Preguntas frecuentes
¿Puedo acelerar cuotas individuales dentro de un mismo plan?
No. Siempre aceleras el plan completo (el ctx). Al confirmar la operación, anticipamos todas las cuotas restantes de ese plan.
¿Cuándo se cobra el valor acelerado?
Ingresa a la factura corriente y se cobra al vencimiento — en la fecha del due_date que retornamos en la simulación, no en el momento de la confirmación.
¿Qué debo hacer si has_pending_operations retorna true?
Te recomendamos mostrar un aviso al usuario, porque hay operaciones en procesamiento que pueden alterar el valor simulado antes de la confirmación.
¿Por cuánto tiempo es válida una simulación?
Hasta las 00:00h del mismo día. Después de ese horario, necesitas generar una nueva simulación antes de confirmar la aceleración.
¿Puedo acelerar solo algunos de los planes vigentes?
Sí. Puedes pasar un subconjunto de los transaction_ids para acelerar solo esos planes, o pasar todos para acelerar la deuda completa.