El ciclo de vida de la solicitud
Una solicitud pasa por estados con nombre. Cada transición es una operación distinta, y cada una guarda un registro de decisión o de desembolso:
Pasos
1
Previsualizar el cronograma (opcional)
POST /api/v1/loan-applications/preview-schedule calcula el cronograma de amortización para términos propuestos sin originar nada. Úsalo para mostrar cuotas y divulgaciones antes de que alguien se comprometa.2
Enviar la solicitud
POST /api/v1/loan-applications crea la solicitud contra una versión de producto.3
Decidir
Resuelve la solicitud con exactamente una de las siguientes:
POST /api/v1/loan-applications/{id}/approve: acéptala, con un registro de decisión.POST /api/v1/loan-applications/{id}/reject: recházala, con un registro de decisión.POST /api/v1/loan-applications/{id}/withdraw: retírala mientras está pendiente de aprobación o, después de la aprobación, antes del desembolso.
4
Desembolsar
POST /api/v1/loan-applications/{id}/disburse registra los fondos entregados. Envía una clave X-Idempotency: mientras el almacén de idempotencia esté accesible, un reintento con la misma clave repite la primera respuesta y no registra un segundo desembolso. El middleware falla en modo abierto durante una caída del almacén de idempotencia, así que confirma el resultado antes de reintentar una falla ambigua.Una sola transacción de base de datos confirma el evento de desembolso, el cronograma de originación y una intención de asiento balanceada. Cuando la llamada retorna, el préstamo es una cuenta de préstamo activa que administras de aquí en adelante.La contabilización en el ledger no está dentro de esa transacción. Con el relay del ledger configurado, un despachador del outbox transmite la intención a Midaz poco después de la respuesta, a través del perfil contable del producto. De lo contrario, la intención permanece en el outbox. Consulta la ruta de asiento.Lo que obtienes
El desembolso produce una cuenta de préstamo, la vista de administración del contrato vivo, que lleva su cronograma, sus transacciones, sus cargos y su historial de auditoría. Continúa en Administrar un préstamo.
Lo que ocurre downstream
Con el streaming habilitado y un broker configurado, el ciclo de vida emite
loan_application.submitted.v2, loan_application.approved.v2, loan_application.rejected.v2, loan_application.withdrawn.v2 y loan_application.disbursed.v2. El desembolso registra una intención de asiento durable y la transmite al ledger solo cuando el relay del ledger está configurado. Consulta la ruta de asiento.
La originación brasileña agrega pasos regulados (divulgación de CET y consentimiento de capitalización) que cubre el Paquete regulatorio de Brasil. El flujo de consignado con descuento en nómina forma su propio contexto delimitado brasileño. Consulta Consignado privado.
Próximos pasos
Administrar un préstamo
Registra pagos, anticipa, reprograma y corrige una cuenta de préstamo activa.