Logo

🇧🇷 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.

Brazilian banking sector (Febraban)
Standard managed by
All ages, including those without cards
User base
Online-issued barcode invoice
Online payment method
1-2 business days (asynchronous)
Payment confirmation

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

QWhat happens if a consumer only issues a boleto but never pays it?
If no payment is made by the due date, the transaction simply does not go through and the order can be treated as canceled. Since the actual payment conversion rate for issued boletos is not 100%, it is important to set the inventory hold period to align with the due date.
QWhere do consumers pay their boleto?
Most pay by scanning the barcode in their own banking app, while cash users use lotérica (lottery-shop) counters found nationwide. See the separate Lotérica guide page for more detail on this touchpoint.
QIn what currency is boleto settlement made?
Confirmed proceeds are received in BRL and, after conversion, settled in whichever currency selected at contract time among USD, KRW, or JPY. Unlike instant payment methods, the settlement cycle is calculated from the payment confirmation date.
QDo we need to offer boleto alongside Pix?
It depends on your target customer base. If consumers unfamiliar with cards or instant transfers, or high-value planned purchasers, are a meaningful segment, offering boleto alongside can help conversion. Conversely, for low-price, instant-purchase products, a Pix-centered setup may be sufficient.

Official sources on payments in Brazil

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