> ## 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.

# Boletos e pagamento de contas

> Emita boletos e pague contas como tributos DARF e faturas de serviços públicos pelo módulo Payments no Lerian Console, com registro no ledger do Midaz.

**Boletos & Bill Payment** cobre o trilho de boletos do Brasil: a emissão de boletos bancários e o pagamento de contas como documentos de arrecadação DARF e faturas de serviços públicos e de concessionárias. Na plataforma Lerian, você opera essa capacidade pelo **módulo Payments no Lerian Console**, um plugin gerenciado do Midaz provisionado para sua organização.

## O que você pode fazer

***

* **Emitir boletos** com vencimento, registrados no seu ledger do Midaz. Pela API, um boleto também pode ter multa, juros e descontos, e você pode escolher o nosso número dele.
* **Pagar contas** (pagamentos de tributos DARF e contas de serviços públicos e de concessionárias) direto pelo Console.
* **Consultar uma conta** pela linha digitável na [API](https://docs.lerian.studio/pt/reference/interfaces/payments-btg/consult-a-bill-by-digitable-line.md) antes de pagá-la. A resposta mostra o valor, as datas e quem recebe o dinheiro.
* **Acompanhar operações** em um dashboard com cards de KPI, atividade recente e ações rápidas.

## Como um pagamento de conta movimenta o dinheiro

***

1. O ledger reserva o valor na conta de fundeio. Se o saldo ou o limite de cheque especial não permitir, o pagamento falha aqui, e o BTG não o recebe.
2. O Payments envia o pagamento ao BTG.
3. Quando o BTG aceita o pagamento, a API responde `201` e o pagamento fica `CREATED`. Quando o resultado no BTG é desconhecido, a API responde `202` e o pagamento fica `UNCONFIRMED`.
4. Para um pagamento de boleto bancário ou de concessionária, a conciliação lê o pagamento no BTG. Se o BTG não tiver registro dele durante toda a janela que o deploy define, o pagamento falha com `PBP-0211`, e o Payments libera os fundos.
5. Para um pagamento de DARF, os fundos continuam reservados até chegar o resultado do BTG.

> [!WARNING]
>
> Não envie um pagamento `UNCONFIRMED` de novo com um novo `Idempotency-Key`. O BTG pode já ter o pagamento, e uma segunda requisição pode pagar a conta duas vezes. Reenviar com a mesma chave é seguro.

## Encontre um pagamento depois de um erro

***

Uma requisição que cria um pagamento pode terminar sem o id do pagamento, por exemplo depois de um timeout ou de uma resposta com status `5xx`. Primeiro, envie a requisição de novo com o mesmo `Idempotency-Key`. Depois de um `409` com `PBP-0007` ou de um `503` com `PBP-0008`, espere e envie de novo com a mesma chave. Depois que a mesma chave retornar outra resposta, chame [`GET /v1/payments`](https://docs.lerian.studio/pt/reference/interfaces/payments-btg/list-payments) com `idempotencyKey` igual a essa chave para encontrar o que a requisição criou. Envie o mesmo `X-Organization-Id` dessa requisição.

Depois de enviar uma requisição de novo com um novo `Idempotency-Key`, não a envie de novo com a chave antiga. A chave antiga pode executar a requisição de novo, e as duas requisições podem pagar.

## Por onde começar

***

> [card] [Payments no Lerian Console](https://docs.lerian.studio/pt/interfaces/payments-btg/console/payments-introduction.md)
>
> Ative o plugin Payments e faça um primeiro tour pelo módulo.

> [card] [Visão geral do Payments](https://docs.lerian.studio/pt/interfaces/payments-btg/console/payments-overview.md)
>
> O dashboard: cards de KPI, operações recentes e atalhos.

> [card] [Boletos](https://docs.lerian.studio/pt/interfaces/payments-btg/console/payments-boletos.md)
>
> Emita, consulte e gerencie boletos.

> [card] [Pagamento de contas](https://docs.lerian.studio/pt/interfaces/payments-btg/console/payments-bill-payments.md)
>
> Pague DARF e contas de serviços públicos pelo Console.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.