El ciclo de vida de la solicitud
Una solicitud recorre estados con nombre. Cada transición es una operación distinta, y cada una guarda un registro de decisión o desembolso:
Pasos
1
Previsualiza el cronograma (opcional)
POST /api/v1/loan-applications/preview-schedule calcula el cronograma de amortización para términos prospectivos sin originar nada. Úsalo para mostrar cuotas y divulgaciones antes de que alguien se comprometa.2
Envía la solicitud
POST /api/v1/loan-applications crea la solicitud contra una versión del producto.3
Decide
Resuelve la solicitud con exactamente una de:
POST /api/v1/loan-applications/{id}/approve— acéptala; se guarda 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 espera aprobación o, después de aprobarla, antes del desembolso.
4
Desembolsa
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 abierto durante una caída del almacén de idempotencia, así que confirma el resultado antes de reintentar una falla ambigua.Una transacción de base de datos confirma el evento de desembolso, el cronograma de originación y una intención de posting balanceada. Cuando la llamada retorna, el préstamo ya es una cuenta de préstamo activa que servicias de aquí en adelante.La contabilización en el ledger no está en esa transacción. Cuando el relay del ledger está configurado, un dispatcher 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 queda en el outbox. Lee la ruta de posting.Qué obtienes
El desembolso produce una cuenta de préstamo — la vista de servicing del contrato vivo, que lleva su cronograma, transacciones, cargos e historial de auditoría. Continúa en Servicing de un préstamo.
Qué pasa downstream
Cuando el streaming está habilitado y hay 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 posting durable y la transmite al ledger solo cuando el relay del ledger está configurado. Lee la ruta de posting.
La originación brasileña añade pasos regulados — divulgación de CET y consentimiento de capitalización — cubiertos en el Pack regulatorio de Brasil. El flujo de consignado con descuento en nómina forma su propio contexto brasileño acotado. Consulta Consignado privado.
Próximos pasos
Servicing de un préstamo
Registra repagos, prepaga, reprograma y corrige una cuenta de préstamo activa.