Skip to main content

Boletos

The Boletos API lets you create single, installment, and batch bank slips (boletos) for one or multiple customers, as well as subscribe to boleto events. With this API, you can create boletos with barcodes and QR codes for payment via Pix.

A boleto has three participants:

  • The issuer or beneficiary, who sold a product or service and issued the boleto.
  • The payer, who will pay the boleto.
  • The guarantor assignor, who issues the boleto on behalf of another company.

To issue a boleto, only the payer's information is required.

Use Cases​

  • Use BTG Empresas boletos as a payment method.
  • Create boletos from a business management system.
  • Integrate with accounts receivable systems.
  • Mobile apps that issue and manage boletos.

Settlement​

Boleto settlement occurs on D+1, regardless of the settlement time.

Via webhook, the settlement date is returned as settledAt in the bank-slips.paid event.

Interest and penalty for a hybrid boleto (with QR code)​

A hybrid boleto has its interest and penalties calculated based on its payment method. As a result, there will be a difference between amounts paid via QR code and via traditional methods.

In both payment cases, interest is calculated using the following equation:

Interest and penalty for payment via traditional methods (barcode, payment line)​

Interest and penalty for payment via QR code​

For payment via QR code, there is an additional rule applied in the calculation:

Therefore:

Available Resources​

The Boletos API resources are available in the API Reference.

📘 API Reference