/api/v1/br/...) e se aplica aos empréstimos originados sob a jurisdição do Brasil. Os termos de domínio em português são mantidos como estão — veja Conceitos fundamentais para a lista completa.
CET — Custo Efetivo Total
O CET (Custo Efetivo Total) é o custo integral divulgado ao tomador — juros mais tributos e tarifas. O Lender persiste a divulgação de 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
O IOF (Imposto sobre Operações Financeiras) é o tributo federal sobre operações de crédito. Pré-visualize os valores de tributos que uma operação prospectiva incorreria antes de originá-la:
POST /api/v1/br/tax/preview
Consentimento de capitalização
A capitalização de juros compostos exige o consentimento explícito do tomador. O Lender registra esse consentimento como uma cerimônia com integridade verificada: o cliente envia o texto da cláusula e seu hash, e o servidor canonicaliza o texto, recalcula o hash e rejeita qualquer divergência — assim o consentimento registrado é comprovadamente a cláusula que o tomador viu.
POST /api/v1/br/loan-applications/{id}/capitalization-consents
Staging de PDD
A PDD (Provisão para Devedores Duvidosos) é o provisionamento para perdas. Cada conta de empréstimo está num estágio de PDD, e mudanças de estágio são transições rastreadas em vez de sobrescritas silenciosas. Um job diário de promoção avança os estágios à medida que os empréstimos envelhecem.
| Operação | Propósito |
|---|---|
GET /api/v1/br/loan-accounts/{id}/pdd-stage | Lê o estágio de PDD vigente. |
POST /api/v1/br/loan-accounts/{id}/pdd-stage/transitions | Aplica uma transição de estágio de PDD. |
Descritor de operação de crédito
O descritor de crédito é o perfil de operação de crédito no estilo SCR de 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
Antes de registrar um pagamento antecipado brasileiro, obtenha uma cotação vinculante da liquidação antecipada, e depois liquide contra ela. A rota de pagamento antecipado BR espelha a genérica e preserva o tratamento consciente de idempotência.
| Operação | Propósito |
|---|---|
POST /api/v1/br/loan-accounts/{id}/prepayment-quote | Cria uma cotação de pagamento antecipado (parcial ou total). |
POST /api/v1/br/loan-accounts/{id}/prepayments | Paga antecipadamente a conta de empréstimo (alias BR). |
Tetos de CDC
Produtos brasileiros de crédito ao consumidor (CDC) podem carregar tetos regulatórios — por exemplo, um limite de multa por atraso. O Lender impõe os tetos recusando um encargo que os violaria, em vez de silenciosamente aparar o valor, assim o contrato e sua trilha de auditoria ficam explícitos sobre o que foi recusado.
Calendário de dias úteis
A aritmética de datas brasileira (apropriações, datas do cronograma, liquidação) usa um calendário de dias úteis brasileiro com feriados ANBIMA e uma convenção de contagem de dias Actual/252, de modo que as datas de parcelas e apropriações caiam em dias úteis.
Produtos BR
Produtos brasileiros são criados e versionados por meio de aliases conscientes de 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 principal — crédito com desconto em folha de ponta a ponta.