O que você recebe
Lender
O motor da jornada de crédito. Ele possui os produtos de empréstimo, a originação, a gestão da carteira, as regras de lançamento e as execuções de acréscimo, e a trilha de auditoria, para crédito ao consumidor (CDC). O ledger continua sendo a fonte de verdade dos saldos.
Consignado CLT (Dataprev)
O trilho nativo para o programa Crédito do Trabalhador do Dataprev, para crédito consignado do setor privado.
Midaz
A fonte de verdade dos saldos. Ele recebe cada desembolso e cada acréscimo de juros como uma transação balanceada de partidas dobradas.
Access Manager
Emite as credenciais machine-to-machine e o JWT de curta duração que o relay do ledger carrega, por tenant.
Matcher
Transforma um veredito de conciliação em uma ação de gestão da carteira. O Lender consome a execução de match concluída.
Streaming Hub
Entrega fatos do Lender e do Consignado para um webhook, uma fila na nuvem, ou um cursor que você consulta.
Como as peças se encaixam
- Seu canal chama o Lender por HTTP. Produtos de empréstimo, solicitações, contas de empréstimo, execuções de acréscimo, e os registros regulatórios brasileiros ficam todos sob
/api/v1. Não existe biblioteca cliente para instalar. - Para um crédito consignado, o Lender emite um comando no seu tópico de comandos. O trilho lê esse comando e chama o Dataprev com o código de solicitante do tenant, as credenciais OAuth e o certificado ICP-Brasil.
- O trilho publica fatos de negócio de volta no seu próprio tópico. O Lender consome esses fatos e move a solicitação de empréstimo pelas suas etapas.
- Um desembolso ou um acréscimo de juros grava uma intenção de lançamento durável. A intenção fica na mesma transação de banco de dados que muda o estado do domínio.
- O relay do ledger lança a transação balanceada de partidas dobradas no Midaz através do SDK oficial. Cada lançamento carrega uma chave de idempotência determinística, então um lançamento repetido colapsa em uma única transação no Midaz.
- O relay alcança o Midaz através do Access Manager. Ele se autentica com credenciais machine-to-machine e um JWT de curta duração, por tenant.
- O Lender publica os próprios fatos no seu próprio tópico de eventos. O Streaming Hub acompanha esse tópico e entrega cada evento correspondido para um destino que você possui.
O que cada peça possui
Adote uma peça de cada vez
1
Rode um primeiro empréstimo só com o Lender
PostgreSQL e Valkey são os serviços que a originação precisa. A produção também exige um provedor de identidade para autorização de rota. Um primeiro empréstimo não precisa de Midaz nem de RedPanda. A intenção de lançamento fica durável no outbox até você configurar um ledger.
2
Configure o relay do ledger
Aponte o Lender para o Midaz e para o Access Manager. O Lender então lança cada desembolso e cada acréscimo como uma transação balanceada. Antes de o relay lançar, o Lender garante que cada alias de conta no perfil contábil existe. Ele pula as contas externas, e nunca cria ativos.
3
Adicione o trilho Consignado CLT (Dataprev)
O crédito consignado do setor privado alcança o programa Crédito do Trabalhador do Dataprev através do trilho nativo. Registre o certificado ICP-Brasil do tenant, as credenciais OAuth, e o código de solicitante de três dígitos antes da primeira chamada.
4
Feche o loop nos fatos
Ative o streaming e assine os fatos do Lender no Streaming Hub. Quando você conciliar com o Matcher, primeiro alinhe o contrato de evento nos dois lados. Depois ative o listener do Matcher no Lender.
Traga o seu
- Os seus canais. A API REST é toda a superfície de cliente, então você chama o Lender a partir da stack que você já roda.
- A sua custódia de segredos. O relay lê as credenciais machine-to-machine dele a partir do AWS Secrets Manager, ou do HashiCorp Vault KV v2 quando você o seleciona.
- Os seus protocolos de identidade. O provedor de identidade do Access Manager aceita OAuth 2.0 e OIDC, SAML 2.0, provisionamento SCIM 2.0, e LDAP contra um diretório externo.
- Os seus consumidores de eventos. Uma subscription do Streaming Hub entrega para um webhook, um cursor de pull, Amazon SQS, RabbitMQ, ou Amazon EventBridge.
- As suas fontes de conciliação, através do Matcher. Veja Conciliação.
Um exemplo prático
Este exemplo acompanha um crédito consignado do setor privado desde a primeira chamada até o lançamento no ledger.
- Seu canal cria a solicitação de empréstimo no Lender contra uma versão de produto de empréstimo.
- O Lender emite o comando de solicitação de margem. O trilho executa a leitura de margem do trabalhador contra o Dataprev e retorna a resposta do trilho, sem transformá-la em uma decisão de análise de crédito.
- Você precifica o empréstimo e o aprova sob a sua própria política de crédito. O Lender registra a taxa contratada, o CET, o IOF, e o plano de parcelas como fatos, e os vincula à versão do produto.
- A originação brasileira adiciona etapas regulamentadas. O Lender registra a divulgação do CET. Ele também registra o consentimento de capitalização, com o texto da cláusula e o hash que recalcula.
- O trilho registra o contrato com o Dataprev, anexa o documento CCB, e publica os fatos de registro e pagamento. O Lender consome o registro do contrato e a confirmação do desembolso.
- O Lender confirma o evento de desembolso, o cronograma de originação, e a intenção de lançamento em uma única transação de banco de dados. O relay lança a transação balanceada no Midaz logo após a resposta.
- Cada execução de acréscimo lança da mesma forma, com a mesma garantia de idempotência. Se você concilia, uma execução de match concluída move o estágio de gestão da carteira e cria a intenção de lançamento correspondente.
Comece aqui
O que é o Lender?
Os cinco domínios da jornada de crédito, e o que cada um possui.
Início rápido do Lender
Seis chamadas de um banco de dados vazio até um empréstimo desembolsado.
Consignado CLT (Dataprev)
O que o trilho de consignado cobre, e onde a responsabilidade dele termina.

