Skip to main content
Una vez que un préstamo se desembolsa se convierte en una cuenta de préstamo — la vista de servicing del contrato vivo. El servicing es todo lo que pasa a lo largo de su vida: entra dinero, cambia el cronograma y se corrigen errores sin reescribir nunca el historial.

​
Lee la cuenta

​
Registra dinero

1

Previsualiza la asignación

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

Registra el repago

POST /api/v1/loan-accounts/{id}/repayments registra el dinero recibido y lo asigna a lo largo del cronograma. Envía un id de request 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 de efecto devuelve el repago ya registrado. El mismo id con datos distintos responde 409. Lee Idempotencia.
3

Prepaga

POST /api/v1/loan-accounts/{id}/prepayments liquida el préstamo antes de tiempo, total o parcialmente. Una cuenta de préstamo brasileña necesita antes una cotización de prepago.

​
Cambia el cronograma

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

​
Corrige sin destruir

Las correcciones preservan una línea de tiempo consistente y auditable. Para deshacer una transacción registrada, revíertela: POST /api/v1/loan-accounts/{id}/transactions/{transactionId}/reverse Una reversión agrega una transacción compensatoria en lugar de borrar nada, así la cuenta conserva un registro de auditoría completo. Una reversión toma un id de request en los mismos headers que un repago. El mismo id repite la reversión ya registrada solo cuando también coincide cada hecho de la reversión: la transacción que se reversa, 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.
El servicing nunca edita el pasado. Repagos, reprogramaciones y reversiones agregan hechos nuevos. El estado vigente se vuelve a derivar de ese historial, así la cuenta siempre se explica desde su propio registro.

​
Qué pasa downstream

Cuando el streaming está habilitado y hay un broker configurado, el servicing emite repayment.recorded, repayment_reversal.recorded, loan_schedule.prepayment_applied y loan_schedule.rescheduled. Un prepago liquidado contra una cotización de prepago brasileña registra una intención de posting durable y la transmite al ledger solo cuando el relay del ledger está configurado. Lee la ruta de posting.

​
Próximos pasos

Contabilidad y ejecuciones de devengo

Reconoce interés a lo largo del tiempo y lee la referencia de asiento que registra cada ejecución.

Pack regulatorio de Brasil

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