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:
Passos
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.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.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.
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.

