Skip to main content
The Bill Payments page in 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 bill payments in a data table. Use the Filters section to narrow the payments shown by status, type, or creation date range. Click a row to open the payment’s details page. 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 with the Pay bill tab active.
3
Fill in the fields:
  • Digitable line or barcode (required): the full digitable line or barcode from the bill. For a 47-digit line, the form shows the amount and the due date that it reads from the line. It warns you if that due date has passed.
  • Source account ID (required): the Midaz account to debit for this payment.
  • 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:
  • Treasury revenue code (required): the revenue code, 4 to 20 digits (for example, 0190).
  • DARF type (required): Normal DARF or Simples DARF.
  • Reference date (required): the competency or reference date for the tax. It cannot be in the future.
  • Due date (optional): the due date for the payment.
  • Principal amount (required): the main tax value (R$).
  • Interest (required): the interest amount due (R$). The field starts at zero.
  • Fine (required): the fine amount due (R$). The field starts at zero.
The Total amount summary updates as you fill in the amount fields.
  • Source account ID (required): the Midaz account to debit. The DARF is filed in the name of this account’s holder.
  • Reference number (optional): an internal reference for this DARF payment.
  • Description (optional): an internal note for this payment.
  • History (optional): the history text for this DARF payment.
4
Click Pay DARF.

​
Payment states

A bill payment can show these states:
  • Created: the plugin sent the payment to the provider and waits for its confirmation.
  • 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: the payment was canceled and does not complete.

​
Error handling

The form checks each field before it sends the request. If the service refuses the payment, an error message appears. The details page of a Rejected payment says that the provider rejected it. The details page of a Failed payment shows the Failure details in the Status history.
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.

Payments introduction

Boletos