Bank Slips (Boleto) Payments

Considerations over paying Boleto's and special scenarios while interacting with Pluggy Payments API.

Within Pluggy's payment solution, you can also pay a bank slip (boleto). This payment can be made either payment one or several boletos.

To pay a boleto (bill) it's necessary to inform the digitable line. The digitable line is made up of 47 or 48 digits separated into 5 fields. I.e.:

00190500954014481606906809350314337370000000100

  1. Os três números iniciais indicam o código do banco emissor, de acordo com tabela da Febraban.
  2. O quarto número representa o tipo da moeda: 9 para o Real e 0 para outras moedas.
  3. Os próximos 25 números são definidos pelo banco emissor. Cada instituição pode usá-los como preferir. Geralmente, eles trazem informações sobre a pessoa ou empresa cobradora, número da agência, número identificador do boleto, etc.
  4. O 30º número, que fica isolado em um campo, é o dígito verificador. Ele é gerado a partir do cálculo dos números anteriores e tem a função de garantir que os códigos estejam todos corretos.
  5. Os quatro números que aparecem depois do dígito verificador são fixos em “0000”.
  6. Os dez últimos algarismos indicam o valor do documento sem desconto. Ex.: se o boleto tem o valor de R$1000,00, o final será: 0000100000.

Paying a Boleto

Using Pluggy's API to pay a boleto is fast, simple, and secure. To do so, first, you need to create a payment request passing the boleto's digitable line to our API. The response should contain a payment URL, in which you can use to pay the boleto.

If you want to pay several boletos at once, you can use Pluggy's bulk payment, passing the id of each boleto's payment requests.


Penalties & Expired boletos

If a boleto is has already passed its dueDate, it's still possible to create the payment request, but penalties will be recalculated for it.

When the boleto has penalties already configured, our payment request will recalculate & provide the updated due date and amount to be paid.


Validations & Errors

When creating a Payment Request from a boleto if it's invalid, the payment request will not be created.
Any mistake on the digitable line's digits will be considered as invalid boleto.

If a boleto is expired, the payment request will not be created and you will receive a message saying that the boleto is expired.

If a boleto is already paid or canceled, the payment request will not be created and you will receive a message saying that the boleto is paid or canceled.