Boleto
Accept Boleto Bancário payments in Brazil with voucher-based checkout that lets customers pay at banks, ATMs, or through online banking
Payment typeCash payment
Payment flowDirectRedirect
Checkout
| Integration type | API v1 |
Coverage
| Countries | Brazil (BR) |
| Currencies | Brazilian Real (BRL) |
| Min amount | 1 BRL |
| Max amount | 250,000.00 BRL |
Capabilities
| Recurring | No |
| Refund | Yes |
| Partial refunds | No |
| Multiple partial refunds | No |
| Chargeback | No |
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 payable via ATMs, banks, convenience stores, or supermarkets.
Principle of operation
- Selection at checkout
Customer pays with Boleto and automatically generates a voucher. - Payment initiation
Customer receives the Boleto voucher, which can be paid at ATMs, banks, convenience stores, or supermarkets. - Payment confirmation
Customer completes the payment at ATMs, banks, convenience stores, or supermarkets. - Merchant notification
Merchant receives a notification Webhook confirming the payment status.
Boleto vouchers have an expiration period. Late payments may incur additional fees or may not be processed.
Handle Boleto errors
Specific errors may occur when a Boleto payment attempt fails.
-
Guide
This error indicates an issue with the provided data format. 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 Guide
Follow implementation best practices for the payment form including error handling, mobile optimization, and production validation steps. document number is correct and matches the required format.
Looking for help? Contact us
Stay informed with Changelog