Boleto (Boleto Bancário) is a widely recognized cash payment method in Brazil, regulated by the Central Bank of Brazil.

This method caters to the 35% of Brazilians without bank accounts by providing a voucher system.

The vouchers can be paid via ATMs, banks, convenience stores, or supermarkets.

Payment type Cash payment

Payment flow Direct / Redirect

Integration type API Reference

Countries Brazil (BR)

Currencies Brazilian Real (BRL)

Min amount 1 BRL

Max amount 250,000.00 BRL

Recurring No

Refund Yes

Partial refunds No

Multiple partial refunds No

Chargeback No

Principle of operation

  1. Selection at checkout
    Customer pays with Boleto and automatically generates a voucher.
  2. Payment initiation
    Customer receives the Boleto voucher, which can be paid at ATMs, banks, convenience stores, or supermarkets.
  3. Payment confirmation
    Customer completes the payment at ATMs, banks, convenience stores, or supermarkets.
  4. Merchant notification
    Merchant is promptly notified once the payment is made.

Boleto vouchers have an expiration period. Late payments may incur additional fees or may not be processed.

Boleto payment flow Boleto payment page example Boleto payment page example Boleto payment page example

Handle Boleto errors

Specific errors may occur when a Boleto payment attempt fails.

  • 2.01 Invalid data
    The decline may be related to an invalid or incorrectly formatted payer identification document (CPF). Retry the transaction and verify that the document number is correct and matches the required format.