Pular para o conteúdo principal
A originação é a jornada de “um tomador quer crédito” até “existe uma conta de empréstimo e os recursos estão liberados”. O Lender a modela como um ciclo de vida explícito da proposta, para que cada decisão fique registrada e cada desembolso seja rastreável.

O ciclo de vida da proposta


Uma proposta percorre estados nomeados. Cada transição é uma operação distinta, e cada uma guarda um registro de decisão ou desembolso:
                aprovar ─────────► desembolsar
              ╱                                ╲
enviar ──────┤                                  └─► conta de empréstimo
              ╲ recusar
               ╲ retirar

Passos


1

Pré-visualize o cronograma (opcional)

POST /api/v1/loan-applications/preview-schedule calcula o cronograma de amortização para termos prospectivos sem originar nada. Use-o para mostrar parcelas e divulgações antes de alguém se comprometer.
2

Envie a proposta

POST /api/v1/loan-applications cria a proposta contra uma versão de produto ativa. As escritas são idempotentes — envie uma chave de idempotência e um envio reexecutado colapsa para a mesma proposta.
3

Decida

Resolva a proposta com exatamente uma de:
  • POST /api/v1/loan-applications/{id}/approve — aceite-a; um registro de decisão é guardado.
  • POST /api/v1/loan-applications/{id}/reject — recuse-a, com um registro de decisão.
  • POST /api/v1/loan-applications/{id}/withdraw — retire-a antes de ela ser decidida.
4

Desembolse

POST /api/v1/loan-applications/{id}/disburse libera os recursos. O Lender registra os fatos do desembolso, contabiliza o desembolso no ledger através do perfil contábil do produto, e o empréstimo se torna uma conta de empréstimo ativa que você faz servicing daqui em diante.

O que você recebe


O desembolso produz uma conta de empréstimo — a visão de servicing do contrato vivo, carregando seu cronograma, transações, encargos e histórico de auditoria. Continue em Fazer servicing de um empréstimo.

O que acontece downstream


O ciclo de vida emite loan_application.submitted, loan_application.approved, loan_application.rejected, loan_application.withdrawn e loan_application.disbursed. O desembolso também impulsiona um posting no ledger pela rota de posting.
A originação brasileira acrescenta etapas reguladas — divulgação de CET e consentimento de capitalização — cobertas no Pacote regulatório do Brasil. O fluxo de consignado com desconto em folha é originado numa única chamada; veja Consignado privado.

Próximos passos


Fazer servicing de um empréstimo

Registre repagamentos, faça pagamento antecipado, reprograme e corrija uma conta de empréstimo ativa.