> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Originar un préstamo

> Recorre una solicitud de préstamo por su ciclo de vida — previsualiza el cronograma, envía, decide y desembolsa — y observa la cuenta de préstamo que produce.

La originación es la jornada desde "un deudor quiere crédito" hasta "existe una cuenta de préstamo y el desembolso queda registrado". 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:

```
enviar ─────► pending_approval ── aprobar ──► approved ── desembolsar ──► cuenta de préstamo
                    │       │                     │
                 rechazar retirar              retirar
```

## Pasos

***

<Steps>
  <Step title="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.
  </Step>

  <Step title="Envía la solicitud">
    `POST /api/v1/loan-applications` crea la solicitud contra una versión del producto.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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](/es/lender/lender-in-the-platform).
  </Step>
</Steps>

## 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](/es/lender/service-a-loan).

## 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](/es/lender/lender-in-the-platform).

<Info>
  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](/es/lender/brazil-regulatory-pack). El flujo de **consignado** con descuento en nómina forma su propio contexto brasileño acotado. Consulta [Consignado privado](/es/lender/consignado-privado).
</Info>

## Próximos pasos

***

<Card title="Servicing de un préstamo" icon="wrench" href="/es/lender/service-a-loan" horizontal>
  Registra repagos, prepaga, reprograma y corrige una cuenta de préstamo activa.
</Card>
