> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.
# Trilhos de pagamento
> Alcance os sistemas de pagamento do Brasil por mensageria própria da Lerian até o BACEN, ou por um parceiro de conectividade.
Cada sistema de pagamento brasileiro carrega o seu próprio contrato de mensageria, certificação e janelas operacionais. Dependendo do sistema de pagamento, você alcança o BACEN em software próprio da Lerian ou através de um parceiro de conectividade. Os dois modelos preservam o seu ledger, as suas contas, e a sua lógica de negócio.
Um trilho Brasil é o software de mensageria próprio da Lerian que conecta a sua instituição ao BACEN ou a uma infraestrutura de mercado, sem intermediário. Uma interface é a superfície de produto sobre um trilho. A Lerian oferece as suas próprias interfaces (TED Lerian, Pix Lerian) e interfaces de parceiro (Pix JD, Pix BTG, TED JD, Payments BTG). As interfaces de parceiro chegam como plugins do Midaz: serviços com deploy separado que estendem o Midaz e que a Lerian licencia separadamente.
O Pix roda em produção através de duas interfaces. [A interface JD](/pt/interfaces/pix-jd/direct-pix-via-jd) conecta a sua instituição como participante direto através de uma PSTI certificada. [A interface BTG](/pt/interfaces/pix-btg/indirect-pix-overview) conecta você como participante indireto. O TED roda através da JD. Os trilhos nativos da Lerian são software próprio da Lerian para uma conexão direta e não intermediada ao BACEN. Eles não substituem os caminhos JD e BTG.
## O que você recebe
***
Mensageria própria da Lerian direto ao BACEN e às suas infraestruturas de mercado.
A superfície de produto sobre um trilho: a API, a integração com o ledger, e os controles operacionais.
O ledger que registra o dinheiro que uma interface movimenta.
Renderiza o arquivo de remessa CCS diário que o Lerian CCS submete.
Entrega eventos do Lerian CCS e do Lerian SCR para um sink que você possui.
## Como as peças se encaixam
***
```mermaid theme={null}
flowchart LR
App["Sua aplicação"]
Iface["TED Lerian
interface Lerian"]
Rail["Lerian SPB
mensageria nativa para o STR"]
Plugin["Pix JD, Pix BTG, TED JD, Payments BTG
plugins que lançam no Midaz"]
PixLerian["Pix Lerian
interface Lerian, lança no Midaz"]
LerianSPI["Lerian SPI
mensageria nativa para SPI/DICT"]
Partner["JD, BTG, ou o provedor que você contrata"]
Bacen["BACEN"]
Ledger["Seu consumidor de ledger
registra a movimentação"]
Midaz["Ledger Midaz"]
App -->|"chamada de API"| Iface
Iface -->|"mensagens"| Rail
Rail -->|"RSFN, sem intermediário"| Bacen
Rail -.->|"fatos de liquidação"| Ledger
App -->|"chamada de API"| Plugin
App -->|"chamada de API"| PixLerian
Plugin -->|"API do provedor"| Partner
PixLerian -->|"API do provedor"| Partner
Partner -->|"conectividade regulada"| Bacen
PixLerian -->|"SPI/DICT nativo"| LerianSPI
LerianSPI -->|"RSFN, sem intermediário"| Bacen
LerianSPI -.->|"fatos de liquidação"| Ledger
Plugin -->|"lança no Midaz"| Midaz
PixLerian -->|"lança no Midaz"| Midaz
classDef lerian fill:#fff8e1,stroke:#f4b400,color:#333;
classDef yours fill:#e8f0fe,stroke:#4285f4,color:#333;
classDef ext fill:#f1f3f4,stroke:#9aa0a6,color:#333;
class Iface,Rail,Plugin,PixLerian,LerianSPI,Midaz lerian;
class App,Ledger yours;
class Partner,Bacen ext;
```
O caminho nativo tem quatro etapas:
1. Sua aplicação chama o TED Lerian. A interface dá a você a API, os eventos do ledger, e os workflows do operador.
2. O TED Lerian repassa a mensagem ao Lerian SPB, que alcança o STR sobre a RSFN.
3. O Lerian SPB despacha a mensagem ao BACEN, sem nenhum parceiro de conectividade no caminho. O BACEN confirma a liquidação de forma assíncrona.
4. O trilho emite fatos de liquidação e não calcula nenhum saldo próprio. O seu consumidor de ledger registra a movimentação financeira.
O Lerian SPI, o trilho nativo do Pix, tem a mesma forma: ele não mantém posição contábil e emite fatos de liquidação para o seu consumidor de ledger. O Pix Lerian fica acima dele e conecta o Lerian SPI ao restante da sua stack.
O caminho de parceiro tem três etapas:
1. Sua aplicação chama um plugin. Pix JD, Pix BTG, TED JD, e Payments BTG chegam como plugins do Midaz. O Pix Lerian é o próprio plugin de Pix da Lerian, e ele também lança no Midaz.
2. O provedor carrega a conectividade regulada. A JD alcança o SPI e o DICT do BACEN para um participante direto, e a BTG conecta um participante indireto.
3. O Pix JD lança cada movimentação de Pix liquidada no Midaz, com a perna externa contra a conta de clearing. O TED JD reserva fundos no Midaz como uma retenção, e depois os debita quando a transferência se liquida. O Payments BTG registra boletos e pagamentos de contas contra o seu ledger Midaz.
O Pix Lerian é o plugin de Pix da Lerian, e um único plugin atende todos os caminhos abaixo dele. O Midaz é o seu ledger obrigatório. Ele cobre validação de conta, verificação de saldo, lançamento de débito e crédito, e roteamento. O Pix Lerian não fala diretamente com o BACEN. A camada de gateway abaixo dele é um participante direto, uma PSTI certificada, ou o Lerian SPI.
Mais duas cadeias rodam sobre arquivos em vez de mensagens de pagamento.
O Reporter renderiza a sua remessa ACCS001 diária a partir dos dados dos seus clientes. O Lerian CCS lê esse arquivo, monta um item de linha de lote por operação, e o submete através do Lerian STA. O Lerian CCS não se conecta diretamente ao BACEN, e não consegue montar o arquivo sem o Reporter. O BACEN responde pelo canal de arquivo de entrada. Um registro aceito move esse relacionamento de cliente para o estado aceito.
Tribunais emitem ordens de bloqueio de ativos, e o BACEN as entrega pelo seu canal STA. O Lerian SISBAJUD recebe cada ordem como um arquivo de layout fixo. Ele executa o bloqueio ou desbloqueio contra o seu ledger Midaz e relata cada resultado ao BACEN. Nenhuma ordem entra pela API.
O Lerian SLC envia arquivos de liquidação de cartão para a Nuclea sobre a RSFN, e o Lerian SILOC repassa o tráfego de cartão para ela.
## O que cada peça possui
***
| Peça | Fonte de verdade para | Fala com | Você mantém |
| ------------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Trilho nativo (Lerian SPI, SPB, SLC, SILOC) | a mensagem e o seu estado de liquidação | o BACEN ou a infraestrutura de mercado, sem intermediário | o seu ledger, contas, e lógica de negócio |
| Interface Lerian (TED Lerian) | a API, os eventos do ledger, os workflows do operador | o trilho abaixo dela | o contrato da sua aplicação |
| Interface de parceiro (Pix JD, Pix BTG, TED JD, Payments BTG) | a integração com o provedor e os seus lançamentos | a JD ou a BTG, e o Midaz | os dados do seu ledger. A BTG fornece conectividade, não gestão de contas |
| Pix Lerian | a camada de aplicação do Pix: orquestração, chaves, QR codes, disputas | o provedor que você contrata, e o Midaz | o seu ledger. O Pix Lerian exige que você possua a camada de ledger logicamente |
| Midaz | saldos e lançamentos | recebe lançamentos dos plugins | contabilidade pura. Um lançamento do Pix JD não carrega dados de contraparte, e o detalhe bancário fica no próprio registro de transação do plugin |
| Streaming Hub | a entrega dos eventos que o Lerian CCS e o Lerian SCR publicam | o Lerian CCS e o Lerian SCR | os seus sinks e segredos de assinatura |
## Adote uma peça de cada vez
***
Escolha a mensageria nativa para uma conexão direta, ou uma interface de parceiro para conectividade JD ou BTG.
A Lerian define a conexão de uma interface de parceiro com o Midaz no momento do deploy, e a sua aplicação nunca a vê.
No Lerian SPB, registre um lançamento pendente em `str.operation.accepted`. Obtenha a posição final a partir dos fatos `settlement.*`, e deduplique pelo par `(ce-source, ce-id)`.
Adicione o Lerian CCS, o Lerian SISBAJUD, e o Lerian SCR conforme as suas obrigações exigirem.
## Traga o seu
***
* **O seu ledger.** Um trilho nativo emite fatos de liquidação para o seu consumidor de ledger, e não exige nenhum ledger específico.
* **Os seus certificados e chaves.** O [Lerian SLC](/pt/rails/slc/what-is-lerian-slc) delega a assinatura a um backend de custódia que você controla, e a chave privada nunca sai da sua custódia. Cada tenant do Consignado CLT (Dataprev) usa o seu próprio certificado de cliente ICP-Brasil.
* **O seu controle de acesso.** O Access Manager autentica a API de um plugin de parceiro, e o plugin valida cada requisição recebida quando você o habilita.
* **Os seus consumidores de eventos.** O TED Lerian entrega eventos do plano de controle para webhooks que você registra. O TED JD notifica o seu endpoint quando uma transferência se completa, falha, ou precisa de atenção. O trilho Consignado CLT (Dataprev) tem a sua própria API de subscription.
* **Os seus operadores.** Habilite um plugin de pagamento no Lerian Console, e o item de menu dele aparece na barra lateral do módulo Midaz. Se você o desabilitar, a configuração dele permanece.
## Um exemplo prático
***
Um TED através do TED Lerian lança em duas fases:
1. Sua aplicação chama o TED Lerian para enviar a transferência.
2. O Lerian SPB despacha a mensagem STR ao BACEN e retorna o status `ACCEPTED`. Esse status significa aceitação do despacho, não liquidação.
3. O evento `str.operation.accepted` sinaliza essa aceitação. O seu consumidor de ledger registra um lançamento pendente.
4. A operação passa para `CONFIRMED` quando `settlement.settled` chega. O seu consumidor finaliza o lançamento.
5. Em `settlement.returned`, uma devolução confirmada reverte um original liquidado. O seu consumidor reverte o lançamento pai.
O Pix JD faz o lançamento para você. Ele lança cada movimentação de Pix liquidada no Midaz, indexada pelo id de ponta a ponta, para que uma liquidação repetida nunca lance em duplicidade.
## Comece aqui
***
Uma âncora por trilho, e a mensageria que o alcança.
Todas as interfaces, e os caminhos em produção hoje.
Como os dois modelos de conexão se comparam.