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

# Pagamento de contas

> Pague documentos de arrecadação DARF e contas (boletos, faturas de serviços públicos) pelo plugin Payments do Lerian Console: campos obrigatórios, estados do pagamento e tratamento de erros.

A página **Bill Payments** no [Lerian Console](/pt/platform/console/about-lerian-console) permite pagar contas. Ela cobre documentos de arrecadação **DARF** e **contas** como boletos e faturas de serviços públicos. Ela lista os campos que cada formulário precisa, os estados pelos quais um pagamento passa e como tratar erros.

## Acessando a página Bill Payments

***

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

A página mostra todos os pagamentos de contas da organização em uma tabela de dados. Use a seção **Filters** para restringir os pagamentos mostrados.

O canto superior direito da página mostra dois botões:

* **Pay bill**: pague uma conta com a linha digitável ou o código de barras.
* **Pay DARF**: pague um documento de arrecadação DARF. Informe os dados do tributo manualmente.

## Pagando uma conta

***

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

  <Step>
    O painel **New payment** abre à direita. Selecione a aba **Pay bill**.
  </Step>

  <Step>
    Preencha os campos:

    * **Digitable line or barcode** *(obrigatório)*: a linha digitável completa ou o código de barras da conta.
    * **Source account ID** *(obrigatório)*: a conta do Midaz a debitar neste pagamento.
    * **Scheduled date** *(opcional)*: agende o pagamento para uma data futura. Deixe em branco para processar na hora.
    * **Description** *(opcional)*: uma observação interna para este pagamento.
  </Step>

  <Step>
    Clique em **Pay bill**.
  </Step>
</Steps>

## Pagando um DARF

***

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

  <Step>
    O painel **New payment** abre com a aba **Pay DARF** ativa.
  </Step>

  <Step>
    Preencha os campos:

    **Taxpayer**

    * **Person type** *(obrigatório)*: **Individual (PF)** ou **Company (PJ)**. Essa escolha muda o campo de documento abaixo.
    * **CPF** *(obrigatório, quando Individual)*: o CPF do contribuinte (`000.000.000-00`).
    * **CNPJ** *(obrigatório, quando Company)*: o CNPJ da empresa (`00.000.000/0000-00`).
    * **Taxpayer full name** *(obrigatório)*: o nome completo do contribuinte.

    **DARF details**

    * **Treasury revenue code** *(obrigatório)*: o código de receita de 4 dígitos (por exemplo, `0190`).
    * **DARF type** *(obrigatório)*: o tipo do documento DARF.
    * **Reference date** *(obrigatório)*: a data de competência ou referência do tributo.
    * **Due date** *(opcional)*: o vencimento do pagamento.

    **Amounts**

    * **Principal amount** *(obrigatório)*: o valor principal do tributo (R\$).
    * **Interest** *(obrigatório)*: o valor de juros devido (R\$). Informe `0,00` se não houver.
    * **Fine** *(obrigatório)*: o valor da multa devida (R\$). Informe `0,00` se não houver.

    O resumo **Total amount** é atualizado conforme você preenche os campos de valor.

    **Payment**

    * **Source account ID** *(obrigatório)*: a conta do Midaz a debitar.
    * **Reference number** *(opcional)*: uma referência interna para este pagamento de DARF.
  </Step>

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

## Estados do pagamento

***

Um pagamento de conta pode mostrar estes estados:

* **Created**: o plugin registrou o pagamento. Ele aguarda processamento.
* **Scheduled**: o pagamento roda em uma data futura que você definiu.
* **Pending approval**: o pagamento aguarda um aprovador.
* **Approved**: um aprovador aceitou o pagamento. O plugin o executa em seguida.
* **Executed**: o plugin enviou o pagamento ao provedor.
* **Settled**: o provedor confirmou o pagamento. O pagamento está concluído.
* **Rejected**: o provedor rejeitou o pagamento.
* **Failed**: o pagamento não foi concluído. Veja [Tratamento de erros](#error-handling).
* **Canceled**: alguém cancelou o pagamento antes da execução.

<h2 id="error-handling">
  Tratamento de erros
</h2>

***

Se um pagamento não é concluído, ele mostra o status **Rejected** ou **Failed** com um motivo de erro no painel de detalhes. As causas comuns incluem:

* **Linha digitável inválida**: a linha tem formato errado, ou a conta venceu. Verifique a conta e tente de novo.
* **Dados de DARF inválidos**: um código de receita, CPF/CNPJ ou valor errado. Corrija os campos e tente de novo.
* **Saldo insuficiente**: a conta de origem não tem saldo suficiente. Adicione saldo à conta e tente de novo.
* **Erro do provedor**: o provedor de pagamento rejeitou a requisição. Tente de novo ou fale com o suporte.

<Warning>
  O pagamento de contas exige as permissões adequadas do Payments. Se você não vê os botões **Pay bill** ou **Pay DARF**, peça ao seu administrador para verificar as permissões do seu papel.
</Warning>

## Páginas relacionadas

***

<Columns cols={2}>
  <Card title="Introdução ao Payments" icon="money-bill-wave" horizontal href="/pt/interfaces/payments-btg/console/payments-introduction" />

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