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

# Bill Payments

> Pague guias DARF e contas (boletos, concessionárias) pelo plugin Payments do Midaz, acompanhe os estados do pagamento e trate erros.

A página **Bill Payments** permite pagar contas diretamente do Console, incluindo guias de tributos **DARF** e **contas** como boletos e fichas de concessionárias. Nesta seção, você vai aprender a enviar um pagamento pelo [Lerian Console](/pt/lerian-console/about-lerian-console), quais campos são obrigatórios, os estados pelos quais um pagamento pode passar e como tratar erros.

## Acessando a página de Bill Payments

***

Para abrir a página **Bill Payments**, clique em **Payments** → **Bill Payments** no menu lateral esquerdo.

A página exibe todos os pagamentos de contas da organização em uma tabela de dados. Use a seção **Filtros** para refinar os pagamentos exibidos.

No canto superior direito da página, há dois botões disponíveis:

* **Pagar conta** — pague uma conta usando a linha digitável ou o código de barras.
* **Pagar DARF** — pague uma guia de tributos DARF informando os dados do tributo manualmente.

## Pagando uma conta

***

<Steps>
  <Step>
    Na página **Bill Payments**, clique em **Pagar conta**.
  </Step>

  <Step>
    O painel **Novo pagamento** abre à direita. Certifique-se de que a aba **Pagar conta** está selecionada.
  </Step>

  <Step>
    Preencha os campos:

    * **Linha digitável ou código de barras** *(obrigatório)* — a linha digitável completa ou o código de barras da conta.
    * **Source account ID** *(obrigatório)* — a conta Midaz a ser debitada para este pagamento.
    * **Data de agendamento** *(opcional)* — agende o pagamento para uma data futura. Deixe em branco para processar imediatamente.
    * **Descrição** *(opcional)* — uma nota interna para este pagamento.
  </Step>

  <Step>
    Clique em **Pagar conta**.
  </Step>
</Steps>

## Pagando um DARF

***

<Steps>
  <Step>
    Na página **Bill Payments**, clique em **Pagar DARF**.
  </Step>

  <Step>
    O painel **Novo pagamento** abre com a aba **Pagar DARF** ativa.
  </Step>

  <Step>
    Preencha os campos:

    **Contribuinte**

    * **Tipo de pessoa** *(obrigatório)* — **Pessoa física (PF)** ou pessoa jurídica (PJ).
    * **CPF** *(obrigatório)* — o número de CPF do contribuinte.
    * **Nome completo do contribuinte** *(obrigatório)* — o nome completo do contribuinte.

    **Dados do DARF**

    * **Código de receita do Tesouro** *(obrigatório)* — o código de receita de 4 dígitos (por exemplo, `0190`).
    * **Tipo de DARF** *(obrigatório)* — o tipo do documento DARF.
    * **Data de referência** *(obrigatório)* — a data de competência/referência do tributo.
    * **Vencimento** *(opcional)* — a data de vencimento do pagamento.

    **Valores**

    * **Valor principal** *(obrigatório)* — o valor principal do tributo (R\$).
    * **Juros** *(obrigatório)* — o valor de juros devido (R\$). Informe `0,00` se não houver.
    * **Multa** *(obrigatório)* — o valor de multa devido (R\$). Informe `0,00` se não houver.

    O resumo do **Valor total** é atualizado automaticamente conforme você preenche os campos de valor.

    **Pagamento**

    * **Source account ID** *(obrigatório)* — a conta Midaz a ser debitada.
    * **Número de referência** *(opcional)* — uma referência interna para este pagamento de DARF.
  </Step>

  <Step>
    Clique em **Pagar DARF**.
  </Step>
</Steps>

## Estados do pagamento

***

Um pagamento de conta passa pelos seguintes estados:

* **Pendente** — o pagamento foi enviado e está aguardando processamento.
* **Agendado** — o pagamento está agendado para uma data futura.
* **Em processamento** — o pagamento está sendo processado pelo provedor.
* **Pago** — o pagamento foi concluído com sucesso.
* **Falha** — o pagamento não pôde ser concluído (veja [Tratamento de erros](#tratamento-de-erros)).
* **Cancelado** — o pagamento foi cancelado antes do processamento.

## Tratamento de erros

***

Se um pagamento falhar, ele aparece com o status **Falha** e um motivo de erro no painel de detalhes. As causas comuns incluem:

* **Linha digitável inválida** — a linha está malformada ou a conta venceu. Verifique a conta e tente novamente.
* **Dados do DARF inválidos** — código de receita, CPF ou valores incorretos. Corrija os campos e tente novamente.
* **Saldo insuficiente** — a conta de origem não tem saldo suficiente. Adicione saldo à conta e tente novamente.
* **Erro de provedor** — o provedor de pagamento rejeitou a solicitação. Tente novamente ou entre em contato com o suporte.

<Warning>
  Os pagamentos de contas exigem as permissões adequadas de Payments. Se você não vê os botões **Pagar conta** ou **Pagar DARF**, verifique as permissões do seu papel com o administrador.
</Warning>

## Páginas relacionadas

***

<Columns cols={2}>
  <Card title="Payments no Lerian Console" icon="money-bill-wave" horizontal href="/pt/lerian-console/midaz-console/payments-introduction" />

  <Card title="Boletos" icon="file-invoice" horizontal href="/pt/lerian-console/midaz-console/payments-boletos" />
</Columns>