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
When a Boleto payment fails, the decline returns one of the codes below.
Guide
Use the error code reference to identify decline reasons for card and alternative payments and decide on retry or resolution steps.
Boleto error codes
include the customer message and the next step for each code.
Guide
Validate the CPF before you send the request, then create a new order.
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
Configure BIN-based additional fields and styling, then verify supported browsers, translations, and iframe requirements before launching the payment form.
document
number is correct and matches the required format.