Boleto payments
Accept Boleto payments, a voucher-based payment method in Brazil.
Boleto is an official voucher-based payment method in Brazil, regulated by the Central Bank of Brazil. To complete a transaction, customers receive a voucher for the amount due and pay it before expiry at an authorised agency or bank, ATM or online bank portal.
| Payment method family | Vouchers |
|---|---|
| Usability | Reusable |
| Access type | Instant provisional access |
| Payment confirmation timing | Up to 1 business day |
| Settlement timing | Up to 2 business days (T+2) |
| Pricing | View pricing details |
Eligibility and availability
Account eligibility
| Business location | Brazil |
|---|---|
| Account type | Merchant Platform or marketplace (Connect) |
| Business model | B2B B2C |
Your account might be reviewed after activation to confirm eligibility. While Boleto doesn’t enforce any additional website requirements, make sure that you provide a website that meets the Stripe account activation requirements. You can contact Stripe support to appeal any Boleto capability restrictions.
This payment method doesn’t have any MCC requirements.
Payment support
| Buyer location | Brazil |
|---|---|
| Presentment currency | BRL |
| Geographic coverage | Domestic Crossborder |
| Transaction limits | Minimum amount: 5.00 BRL Maximum amount: 49,999.99 BRL |
Capabilities
| Recurring payments | Supported |
|---|---|
| Payment authorisations | Extended authorisations Flexible extended authorisations Incremental authorisations Decremental authorisations Re-authorisations |
| Payment captures | Manual capture Partial capture Multi-capture Over-capture |
| Refunds | Partial refunds Full refunds |
| Disputes | Partial disputes Full disputes |
Disputes
Boleto doesn’t support the standard dispute process, and customers can’t file a chargeback. However, in some instances, bank-side irregularities similar to disputes can occur, such as payment mishandling. If this happens, Stripe contacts you with next steps.
Stripe product support
| Checkout UIs | Full page Recommended Payment Links Embedded form Express Checkout Element In-app payments |
|---|---|
| Products | Managed Payments Billing Invoicing Adaptive Pricing Customer Portal Radar Terminal Connect |
| APIs | CheckoutSessions Recommended PaymentIntents PaymentIntents with setup_future_usage SetupIntents |
Get started
To get started with one of our hosted UIs, follow a quickstart:
- Checkout : Our prebuilt, hosted checkout page.
- Elements : Our drop-in UI components.
Other payment products
The following Stripe products also let you add Boleto from the Dashboard:
- Invoicing
- Payment Links
- Subscriptions
Check out the Boleto sample on GitHub.
Customer experience
- Select Boleto The customer selects Boleto at checkout and provides the required contact and tax ID details.
- Receive voucher Stripe displays a hosted voucher page where the customer can copy the Boleto number or download the voucher PDF. The voucher expires after 3 days by default, configurable from 0–60 days.
- Pay the voucher The customer pays through a bank, ATM, authorized agency, or online bank portal. Desktop and mobile customers use the same hosted-voucher browser flow.
- Payment complete After the customer pays, Stripe confirms the payment asynchronously, typically on the next business day, and the customer receives confirmation that the payment is complete.
Transaction identifiers
The Boleto voucher or bank receipt might show Stripe as the company. The exact formatting depends on the customer’s bank or payment channel.
For Boleto and other non-card payments, you can set the full statement descriptor using the statement_descriptor parameter. If you don’t set a request-level descriptor, Stripe uses the account-level statement descriptor. The statement_descriptor_suffix parameter only applies to card payments. A bank might display statement-descriptor information differently or omit it.
For Connect destination charges without on_behalf_of, the statement descriptor comes from the platform account. When you use on_behalf_of, it comes from the connected account, subject to legacy API-version behaviour. Learn more about statement descriptors with Connect.
Use payment_intent.next_action.boleto_display_details.number to retrieve the customer-visible Boleto number. This number identifies the voucher, but it isn’t a processor transaction ID. Boleto doesn’t expose a processor transaction ID under latest_charge.payment_method_details.boleto.
Enable Boleto
If you use Stripe front-end products, enable Boleto in your payment method settings. Stripe automatically determines which payment methods are most relevant to each customer.
If your integration requires manually listing payment methods, you can configure Boleto as an accepted payment method.