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

> Pay DARF tax forms and bills (boletos, utility slips) from the Lerian Console Payments plugin: required fields, payment states, and error handling.

The **Bill Payments** page in [Lerian Console](/en/platform/console/about-lerian-console) lets you pay bills. It covers **DARF** tax forms and **bills** such as boletos and utility slips. It lists the fields each form needs, the states a payment moves through, and how to handle errors.

## Accessing the Bill Payments page

***

To open the **Bill Payments** page, click **Payments** → **Bill Payments** from the left-side menu.

The page displays all bill payments for the organization in a data table. Use the **Filters** section to narrow the payments shown.

The top-right of the page shows two buttons:

* **Pay bill**: pay a bill with a digitable line or barcode.
* **Pay DARF**: pay a DARF tax form. Enter the tax details manually.

## Paying a bill

***

<Steps>
  <Step>
    From the **Bill Payments** page, click **Pay bill**.
  </Step>

  <Step>
    The **New payment** panel opens on the right. Select the **Pay bill** tab.
  </Step>

  <Step>
    Fill in the fields:

    * **Digitable line or barcode** *(required)*: the full digitable line or barcode from the bill.
    * **Source account ID** *(required)*: the Midaz account to debit for this payment.
    * **Scheduled date** *(optional)*: schedule the payment for a future date. Leave blank to process immediately.
    * **Description** *(optional)*: an internal note for this payment.
  </Step>

  <Step>
    Click **Pay bill**.
  </Step>
</Steps>

## Paying a DARF

***

<Steps>
  <Step>
    From the **Bill Payments** page, click **Pay DARF**.
  </Step>

  <Step>
    The **New payment** panel opens with the **Pay DARF** tab active.
  </Step>

  <Step>
    Fill in the fields:

    **Taxpayer**

    * **Person type** *(required)*: **Individual (PF)** or **Company (PJ)**. This selection changes the document field below.
    * **CPF** *(required, when Individual)*: the taxpayer's CPF (`000.000.000-00`).
    * **CNPJ** *(required, when Company)*: the company's CNPJ (`00.000.000/0000-00`).
    * **Taxpayer full name** *(required)*: the taxpayer's full name.

    **DARF details**

    * **Treasury revenue code** *(required)*: the 4-digit revenue code (for example, `0190`).
    * **DARF type** *(required)*: the type of DARF document.
    * **Reference date** *(required)*: the competency or reference date for the tax.
    * **Due date** *(optional)*: the due date for the payment.

    **Amounts**

    * **Principal amount** *(required)*: the main tax value (R\$).
    * **Interest** *(required)*: the interest amount due (R\$). Enter `0,00` if none.
    * **Fine** *(required)*: the fine amount due (R\$). Enter `0,00` if none.

    The **Total amount** summary updates as you fill in the amount fields.

    **Payment**

    * **Source account ID** *(required)*: the Midaz account to debit.
    * **Reference number** *(optional)*: an internal reference for this DARF payment.
  </Step>

  <Step>
    Click **Pay DARF**.
  </Step>
</Steps>

## Payment states

***

A bill payment can show these states:

* **Created**: the plugin recorded the payment. It waits to process.
* **Scheduled**: the payment runs on a future date you set.
* **Pending approval**: the payment waits for an approver.
* **Approved**: an approver accepted the payment. The plugin runs it next.
* **Executed**: the plugin sent the payment to the provider.
* **Settled**: the provider confirmed the payment. The payment is complete.
* **Rejected**: the provider rejected the payment.
* **Failed**: the payment did not complete. See [Error handling](#error-handling).
* **Canceled**: someone canceled the payment before execution.

## Error handling

***

If a payment does not complete, it shows a **Rejected** or **Failed** status with an error reason in the details panel. Common causes include:

* **Invalid digitable line**: the line has a wrong format, or the bill expired. Check the bill and retry.
* **Invalid DARF details**: a wrong revenue code, CPF/CNPJ, or amount. Correct the fields and retry.
* **Insufficient funds**: the source account does not have enough balance. Top up the account and retry.
* **Provider error**: the payment provider rejected the request. Retry or contact support.

<Warning>
  Bill payments require the appropriate Payments permissions. If you cannot see the **Pay bill** or **Pay DARF** buttons, ask your administrator to check your role permissions.
</Warning>

## Related pages

***

<Columns cols={2}>
  <Card title="Payments introduction" icon="money-bill-wave" horizontal href="/en/interfaces/payments-btg/console/payments-introduction" />

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