Saltar al contenido principal
La originación es la jornada desde “un deudor quiere crédito” hasta “existe una cuenta de préstamo y los fondos están afuera”. Lender la modela como un ciclo de vida explícito de la solicitud, para que cada decisión quede registrada y cada desembolso sea rastreable.

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:
                aprobar ─────────► desembolsar
              ╱                                ╲
enviar ──────┤                                  └─► cuenta de préstamo
              ╲ rechazar
               ╲ retirar

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 de producto activa. Las escrituras son idempotentes — envía una clave de idempotencia y un envío reintentado colapsa a la misma solicitud.
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 antes de que sea decidida.
4

Desembolsa

POST /api/v1/loan-applications/{id}/disburse libera los fondos. Lender registra los hechos del desembolso, contabiliza el desembolso en el ledger a través del perfil contable del producto, y el préstamo se convierte en una cuenta de préstamo activa que servicias de aquí en adelante.

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


El ciclo de vida emite loan_application.submitted, loan_application.approved, loan_application.rejected, loan_application.withdrawn y loan_application.disbursed. El desembolso también impulsa un posting al ledger vía 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 se origina en una sola llamada; consulta Consignado privado.

Próximos pasos


Servicing de un préstamo

Registra repagos, prepaga, reprograma y corrige una cuenta de préstamo activa.