/api/v1/br/...). Tudo o que está aqui vale para empréstimos originados sob a jurisdição Brasil. Os termos de domínio em português ficam como são, com uma explicação (veja Conceitos centrais para a lista completa).
CET (Custo Efetivo Total)
CET (Custo Efetivo Total) é o custo efetivo total do crédito, o custo completo divulgado ao tomador (juros mais tributos e tarifas). O Lender persiste a divulgação do CET na originação e a expõe por conta de empréstimo:
GET /api/v1/br/loan-accounts/{id}/cet-disclosure
IOF e prévia de tributos
IOF (Imposto sobre Operações Financeiras) é o tributo federal sobre operações de crédito. O perfil brasileiro fixa as alíquotas de IOF, então uma prévia e o desembolso que vem depois dela calculam os mesmos valores. Pré-visualize o componente diário e o adicional do IOF, e o valor líquido que o tomador recebe, antes de originar:
POST /api/v1/br/tax/preview
Consentimento de capitalização
A capitalização brasileira de juros compostos exige o consentimento explícito do tomador. O Lender registra esse consentimento como uma cerimônia com verificação de integridade. O cliente envia o texto da cláusula e o hash dele. O servidor canoniza o texto, recalcula o hash e rejeita qualquer divergência. O consentimento registrado é, portanto, comprovadamente a cláusula que o tomador viu.
POST /api/v1/br/loan-applications/{id}/capitalization-consents
Estágios de PDD
PDD (Provisão para Devedores Duvidosos) é o provisionamento para perdas com empréstimos. Cada conta de empréstimo fica em um estágio de PDD. O Lender registra cada mudança de estágio como uma transição, não como uma sobrescrita silenciosa.
O número de dias em atraso determina o estágio. Os estágios mais avançados também suspendem a apropriação de juros, então a rodada de apropriação deixa essas contas de fora.
Descritor da operação de crédito
O descritor de crédito é o perfil da operação de crédito no estilo SCR para uma conta de empréstimo, a descrição regulada da operação.
GET /api/v1/br/loan-accounts/{id}/credit-descriptor
Cotação de pagamento antecipado
Uma conta de empréstimo brasileira liquida antes do prazo contra uma cotação de pagamento antecipado: crie a cotação primeiro, depois pague antecipadamente com o identificador dela. A cotação vale por 24 horas e aceita uma liquidação, e o valor que você liquida deve ser igual ao valor líquido de liquidação da cotação. A rota BR de pagamento antecipado espelha a genérica e recebe a mesma chave
X-Idempotency.
Tetos do CDC
Produtos brasileiros de crédito ao consumidor (CDC) podem carregar tetos regulatórios, por exemplo um limite para a multa por atraso. O Lender aplica os tetos rejeitando um encargo que os violaria, em vez de reduzir o valor em silêncio. O contrato e a trilha de auditoria dele ficam, assim, explícitos sobre cada recusa.
Calendário de dias úteis
O cálculo de datas no Brasil (apropriações, datas do cronograma, liquidação) usa um calendário brasileiro de dias úteis. Esse calendário tem os feriados ANBIMA e a convenção de contagem de dias Actual/252. As datas de parcela e de apropriação caem, portanto, em dias úteis.
Produtos BR
Você cria e versiona produtos brasileiros por meio de aliases sensíveis à jurisdição que aceitam as extensões BR:
POST /api/v1/br/loan-products,GET /api/v1/br/loan-products,GET /api/v1/br/loan-products/{id}POST /api/v1/br/loan-products/{id}/versions,POST /api/v1/br/loan-products/{id}/activate
Próximos passos
Consignado privado
A jornada brasileira: crédito com desconto em folha de ponta a ponta.