Brazil Boleto Payment Integration Guide
Boleto Bancário is a Brazil-specific invoice-style payment method in which a barcode invoice is issued online at the time of order, and the consumer pays it before the due date via a banking app or at a lottery-shop (lotérica) counter. We outline adoption criteria centered on the fact that it is an asynchronous method requiring 1-2 business days for payment confirmation.
When to consider Boleto payments in Brazil
Even now that Pix accounts for more than about 40% of online payments, boleto remains a persistent method used steadily by consumers with limited access to credit cards or banking apps. In Brazil, a country of more than 200 million people, the share of customers shopping online without a card cannot be ignored, and for these customers, boleto is a method they have grown accustomed to over decades for paying utility bills and installments.
It suits planned purchases where the consumer sets their own payment timing, such as electronics, education services, and travel products, as well as merchants seeking to capture customer segments with high card-decline rates. However, since it is an asynchronous payment requiring 1-2 business days for payment confirmation, you need to design your inventory hold period and unpaid-order auto-expiration policy together with the adoption of this method.
Basic flow of Boleto payments in Brazil
At the order stage, a boleto containing a barcode and a numeric line (linha digitável) is issued online. The consumer either scans the barcode in a banking app or pays in cash at a lotérica counter before the due date, and payment confirmation through the banking network typically takes 1-2 business days. The order is confirmed at the point of payment confirmation, and the proceeds are received in BRL, then converted and settled in whichever currency selected at contract time among USD, KRW, or JPY. It is common practice to automatically cancel orders that remain unpaid past the due date.
Scope of Hecto Financial's Boleto support
Through Hecto Financial integration, Korean merchants can handle everything from boleto issuance to payment-confirmation notification within a single integration. Since payment completion arrives asynchronously with this method, designing webhooks to update order status is important, and actual support terms vary depending on the results of the industry and transaction-volume review.
※ This section describes the general support process and does not guarantee that a specific merchant can actually integrate. Please confirm the exact scope of support and fees through consultation.
What to check before applying and integrating
- Business registration country
Confirm whether a contract is possible based on a Korean business entity
- Sales channels
The integration method and priority vary depending on your online sales channel mix, such as your own store, open marketplaces, or mobile apps
- Product categories handled
You need to check in advance whether your category falls under an industry restricted by Boleto's merchant policy
- Local regulatory compliance
You need to confirm compliance with Brazil's payment and foreign exchange regulations (see official sources below)
Settlement currency, cycle, and refund conditions
Since a boleto transaction starts in a "pending payment" state, the settlement reference point is not the payment request date but the payment confirmation date. Confirmed proceeds are received in BRL and, after conversion, paid out in whichever currency selected at contract time among USD, KRW, or JPY. Refunds are often handled not as a cancellation of the original card-style transaction but as a separate remittance to the consumer's account, requiring a process for collecting refund account information, and the same process applies when responding to the 7-day right-of-withdrawal requests guaranteed under Brazil's CDC.
Brazil Boleto FAQ
What happens if a consumer only issues a boleto but never pays it?
Where do consumers pay their boleto?
In what currency is boleto settlement made?
Do we need to offer boleto alongside Pix?
Official sources on payments in Brazil
- Banco Central do Brasil (Central Bank of Brazil)Official information on Brazil's payment systems and related regulations. If the content of this page differs from actual regulations, the official source takes precedence.
Inquire about adopting Boleto payments in Brazil
The Hecto Financial team will help you review the right combination of payment methods for the Brazilian market.
Contact us