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. Toma la clave X-Idempotency que toma toda escritura de esta página, así que un reintento con la misma clave repite la primera respuesta y no registra un segundo desembolso.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.Toda escritura toma una clave de idempotencia
Crear una solicitud y moverla — aprobar, rechazar, desistir, desembolsar — exigen todas el encabezado
X-Idempotency. Lender lee la clave con esa grafía y con ninguna otra: Idempotency-Key y X-Idempotency-Key se rechazan por nombre, para que un cliente nunca quede desprotegido en silencio por haber adivinado el encabezado. Enviar una de esas junto con el encabezado del contrato no es problema; el rechazo solo se dispara cuando X-Idempotency está ausente.
La guarda falla cerrada. Cuando el almacén de idempotencia no puede responder, el pedido se rechaza con
503 en vez de pasar adelante sin protección.
Crear no costaba nada repetirlo y ahora cuesta una clave, a propósito: un cliente que agota el tiempo al crear y llama de nuevo abre una segunda solicitud para el mismo prestatario. Es el duplicado más barato de producir en el servicio y el más caro de deshacer, porque las dos copias se ven legítimas y solo una persona sabe decir cuál es la verdadera.
En las cuatro escrituras de ciclo de vida, un pedido que termina sin resolverse se puede conciliar y reenviar bajo una clave nueva: lee la solicitud por id y pregunta si ya sostiene el estado que querías. El desembolso es la excepción, donde una clave nueva no es una recuperación segura en absoluto — una segunda liberación legítima declara su tramo.
El producto tiene que estar activo
La originación lee el estado de activación del producto de préstamo y rechaza un producto que no está activo, con
LENDER-0225 y un 422. El rechazo se ubica en los tres pasos que deciden crédito nuevo — crear la solicitud, aprobarla y liberar el dinero por la API —, así que un producto apagado después de presentada la solicitud la detiene antes de que salga el dinero.
Crear una solicitud también tiene que nombrar la versión vigente del producto, o se rechaza con LENDER-0226 y un 422. Esa comprobación corre en la creación y en ningún otro lado, porque una solicitud se queda de por vida en la versión en que nació. Promover una versión nueva nunca mata entonces las solicitudes detenidas en la anterior, y cada una sigue contabilizando en la versión que nombró. Mira Definir un producto de préstamo.
Dos caminos quedan fuera de esta puerta a propósito:
- El carril del consignado, que registra un contrato que los sistemas del propio cliente ya inscribieron en la nómina. Rechazar un hecho que ya ocurrió dejaría al libro negando un contrato que el prestatario tiene en la mano.
- Una renegociación sustancial, cuyo contrato de reemplazo hereda la versión de producto del contrato al que reemplaza, esté ese producto activo o no y sea esa versión la vigente o no. Renegociar es servicing de crédito ya escrito; solo una solicitud nueva es crédito nuevo.
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.