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 lets you pay bills from the Console. It covers DARF tax forms and bills such as boletos and utility slips. This page shows how to submit a payment in the Lerian Console. 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

---

1. From the Bill Payments page, click Pay bill.

2. The New payment panel opens on the right. Select the Pay bill tab.

3. 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.
4. Click Pay bill.

Paying a DARF

---

1. From the Bill Payments page, click Pay DARF.

2. The New payment panel opens with the Pay DARF tab active.

3. 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.
4. Click Pay DARF.

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

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.

Related pages

---

Payments introduction

Boletos