Skip to main content
Uma operação de crédito roda por meses ou anos. Ela toca produto, risco, operações e contabilidade em cada etapa. A maioria das instituições monta isso a partir de um catálogo de produtos aqui, uma ferramenta de originação ali, e a gestão da carteira no core. A Lerian compõe isso a partir de peças separadas, cada uma responsável por uma fronteira. O Lender roda a jornada de crédito, o Midaz guarda os saldos, e o trilho Consignado CLT (Dataprev) possui a fronteira com o Dataprev. Cada peça entrega à próxima um fato registrado, nunca um palpite.

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


  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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 roteamento falha fechado. O perfil contábil resolve a organização e o ledger que recebem cada lançamento. Quando o roteamento não resolve nenhum destino, o Lender recusa o lançamento em vez de registrar em um ledger vazio ou errado. Uma entrada opcional fecha o loop. Quando você concilia com o Matcher, o Lender consome a execução de match concluída e traduz o veredito em uma transição de estágio de gestão da carteira e na intenção de lançamento correspondente. Essa integração é controlada por configuração, e os dois lados devem concordar sobre a fonte de CloudEvents antes de você habilitá-la.

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.
  1. Seu canal cria a solicitação de empréstimo no Lender contra uma versão de produto de empréstimo.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.