Skip to main content
Después del desembolso, un préstamo se convierte en una cuenta de préstamo, la vista de administración del contrato vivo. La administración cubre toda la vida de la cuenta. Entra dinero, el cronograma cambia y corriges errores sin reescribir la historia.

​
Leer la cuenta

​
Registrar dinero

1

Previsualizar la asignación

POST /api/v1/loan-accounts/{id}/preview-repayment muestra cómo asignaría Lender un pago entre las cuotas pendientes sin registrarlo. Lender paga primero la cuota vencida más antigua. Dentro de cada cuota paga penalidades, luego comisiones, luego intereses y luego capital.
2

Registrar el pago

POST /api/v1/loan-accounts/{id}/repayments registra el dinero recibido y lo asigna a lo largo del cronograma. Envía un id de solicitud en X-Request-ID, o en X-Idempotency como respaldo. Una llamada sin ninguno de los dos responde 422. El mismo id con la misma cuenta de préstamo, el mismo monto y la misma fecha efectiva devuelve el pago ya registrado. El mismo id con hechos distintos responde 409. Consulta Idempotencia.
3

Pagar por anticipado

POST /api/v1/loan-accounts/{id}/prepayments liquida el préstamo antes del cronograma, en todo o en parte. Una cuenta de préstamo brasileña necesita primero una cotización de pago anticipado.

​
Cambiar el cronograma

POST /api/v1/loan-accounts/{id}/reschedules reescribe el cronograma restante, por ejemplo para una renegociación. El cambio es un nuevo estado del cronograma, no una edición del anterior.

​
Corregir sin destruir

Las correcciones conservan una línea de tiempo consistente y auditable. Para deshacer una transacción registrada, revértela: POST /api/v1/loan-accounts/{id}/transactions/{transactionId}/reverse Una reversión agrega una transacción compensatoria en lugar de borrar algo, así la cuenta conserva un registro de auditoría completo. Una reversión toma un id de solicitud en los mismos headers que un pago. El mismo id repite la reversión ya registrada solo cuando también coinciden todos los hechos de la reversión. Los hechos de la reversión son la transacción que reviertes, la cuenta de préstamo, la fecha efectiva de la reversión, el motivo, la versión del perfil y el código de jurisdicción. Cualquier diferencia en esos hechos responde 409.
La administración nunca edita el pasado. Los pagos, las reprogramaciones y las reversiones agregan hechos nuevos. El estado actual se vuelve a derivar de ese historial, así la cuenta sigue siendo explicable desde su propio registro.

​
Lo que ocurre downstream

Cuando el streaming está habilitado y hay un broker configurado, la administración emite repayment.recorded, repayment_reversal.recorded, loan_schedule.prepayment_applied y loan_schedule.rescheduled. Un pago anticipado liquidado contra una cotización de pago anticipado brasileña registra una intención de asiento durable. El pago anticipado transmite esa intención al ledger solo cuando configuras el relay del ledger. Consulta la ruta de asiento.

​
Próximos pasos

Contabilidad y ejecuciones de devengo

Reconoce intereses a lo largo del tiempo y lee la referencia de diario que registra cada ejecución.

Paquete regulatorio de Brasil

Lee la etapa de PDD de un préstamo vencido y aplica una transición de etapa.