Introduction

Our API enables you to pay bills directly using the bank slip’s digitable line, in a simple, automated, and secure way.

With it, you can pay utility bills, taxes, supplier invoices, or other charges — instantly or on a scheduled date — all through a single API call.

This section of the documentation aims to explain in detail how the bill payment flow works, including rules, timelines, best practices, and practical usage examples.

How It Works

The bill payment flow via API is straightforward:

1. You send the digitable line of the boleto in the identificationField parameter;
2. Asaas automatically parses the bill information (amount, due date, issuer, etc.);
3. The payment is processed immediately or on the scheduled date (if provided in scheduleDate);
4. The payment status can be tracked through webhooks and query endpoints (/v3/bill).