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 expiration at an authorized 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.
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 authorizations | Extended authorizations Flexible extended authorizations Incremental authorizations Decremental authorizations Re-authorizations |
| 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
| Products | Checkout Payment Links Payment Element Express Checkout Element Mobile Payment Element Managed Payments Billing Invoicing Adaptive Pricing Customer Portal Radar Terminal Connect |
|---|---|
| APIs | PaymentIntents PaymentIntents with setup_future_usage SetupIntents CheckoutSessions |
Get started
To get started with one of our hosted UIs, follow a quickstart:
Other payment products
The following Stripe products also let you add Boleto from the Dashboard:
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 behavior. 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 our front-end products, you can enable Boleto directly from your payment method settings. Stripe then automatically determines the most relevant payment methods to display to your customers.
If your integration requires manually listing payment methods, learn how to manually configure Boleto as a payment.