At the moment, it's not possible to reliably test Boleto payments in test environment. Please, contact our support if you need to test Boleto payments in test environment. We will have to configure your account information specifically for this payment method.
In regards to API requests, following specific test data should be submitted in your Payment API calls on top of regular required parameters.
You should use payment_type=boleto if the payer is a physical person and payment_type=boleto_b2b if the payer is a company.
| Parameter | Value |
|---|---|
| first_name | Joao |
| last_name | Da Silva |
| company_vat_id | 75956344075 if boleto and 24401281000152 if boleto_b2b |
| invoice_date | 25-02-2026 |
| [email protected] | |
| postal_code | 04543011 |
| city | Sao Paolo |
| state | SP |
| country | BR |
| address | Av. Pres. Juscelino Kubitschek |
| address2 | Vila Olímpia |
| currency | BRL |
| amount | 10 |
| phone | 11950505050 |
In the response, you will receive a Boleto barcode such as 21891136700000010000010090560051803378136028. In your checkout, you may choose to display this barcode to the customer as downloadable PDF or e-mail it to them using one of the Boleto javascript libraries.
We recommend to use https://www.guilhermearaujo.dev/boleto.js to convert raw barcode text to displayable image which you can put in a web page, email or a PDF slip.