Antes de começar
- Você precisa de um token bearer do Lender (um JWT emitido pelo seu Access Manager). Cada operação é autenticada e tem escopo por tenant.
- Decida a qual jurisdição o produto pertence — a base genérica ou o Brasil. Produtos brasileiros carregam campos extras cobertos no Pacote regulatório do Brasil.
Passos
1
Crie o produto
POST /api/v1/loan-products registra o produto nomeado. Esta é a entrada de catálogo da qual as versões dependem. (O Brasil tem um alias, POST /api/v1/br/loan-products, que aceita as extensões BR.)2
Crie uma versão
POST /api/v1/loan-products/{id}/versions congela um conjunto de termos — configuração de taxa, prazo e forma do cronograma — como uma versão imutável. Cada empréstimo rastreia a versão com a qual foi originado; você nunca edita uma versão, você publica uma nova.3
Anexe encargos
POST /api/v1/loan-products/{id}/charges aplica um template de encargo (uma tarifa de originação, uma tarifa de serviço) que os empréstimos originados a partir deste produto herdam.4
Amarre um perfil contábil
POST /api/v1/loan-products/{id}/accounting-profiles declara como o produto contabiliza no : as regras de posting (quais lançamentos de partidas dobradas disparam para cada evento) e a organização de ledger e o ledger em que são contabilizados. O Lender se recusa a desembolsar um empréstimo cuja versão não tem perfil, então amarre-o antes de originar. Veja Contabilidade e rotinas de apropriação.5
Ative o produto
POST /api/v1/loan-products/{id}/activate põe o produto em ativo e fixa como versão atual a que você indicar. Cada proposta indica a versão com a qual é originada, então empréstimos existentes mantêm a versão com a qual começaram.Inspecionar produtos
O que acontece downstream
Criar e ativar produtos emite
loan_product.created, loan_product_version.created, loan_product.activated, accounting_profile.configured e loan_charge.applied no backbone de streaming — veja O Lender na plataforma.
Próximos passos
Originar um empréstimo
Pegue um produto ativo e origine um empréstimo contra ele.