Boleto Payments via Stripe 

Boleto is a payment method commonly used in Brazil for payments. It is a type of voucher that customers can use to make payments offline.

A Boleto contains important information such as the payment amount, due date, barcode, and the beneficiary's information. To pay a Boleto, the customer can either print the voucher and use the barcode to pay online or at a bank or convenience store.

Since Brazilians mostly prefer to pay in cash, Boleto is the best solution where a merchant can issue a Boleto to a customer against an invoice and the customer can use it to pay in cash at their convenience before expiry.

Prerequisites 

The following prerequisites are important for accepting payments via Boleto:

1. Make sure you have configured a valid Brazil-based Stripe account to your Chargebee site.
2. Make sure you add the BRL currency to your Chargebee site as Boleto expects BRL currency for creating vouchers.
3. Make sure you have enabled Boleto in Offline Payment Methods in your Chargebee site
4. Make sure you have configured Smart Routing for the correct Stripe account with Boleto.

Adding BRL Currency 

1. Go to Settings > Configure Chargebee > Currencies

   

2. Click Add Currency

   

3. Select BRL from the drop-down menu.

4. Choose how you like to set the exchange rate from the options. You can either choose to set the rate yourself or let Chargebee set it for you.\

5. Click Add Currency

   

Configuring Boleto via Stripe in Chargebee 

1. Go to Settings > Configure Chargebee > Payment Gateways
2. Select the relevant Stripe account
3. Enable Boleto
4. Click Apply
   

Enabling Offline Payment for Boleto 

Follow the steps below:

1. Go to Settings > Configure Chargebee > Offline Payment Methods

   

2. Enable Offline Payment Methods if not already enabled.

3. Enable Boleto

   

4. Verify and update the details in the fields (if required).

   

5. Click Save

6. Click Apply

   

Email Notifications 

You can add a payment voucher button for Boleto or a voucher link using a mergevar in invoice and dunning-related emails.

Follow the steps to add a payment voucher button to the email template:

1. Go to Settings > Configure Chargebee > Email Notifications.

2. Select Standard Emails under Manual Emails.

   

3. Click Edit for the Send Invoice email.

   

4. In the email body, click the + button, click Add Button, and then click Payment Voucher. You can also customize the name and alignment of this button.

   

5. Since the Boleto payment method email address may vary from the customer email address, a merchant can choose to send the email to the payment method email as well by enabling Send to payment method email address.

   

6. Alternatively, you can also add a voucher link using a mergevar. Follow the steps to do so:

   1. Add a placeholder text for the voucher link in the email template body.
   2. Edit the text and add the {{invoice.payment_voucher_url}} mergevar as a hyperlink.

NOTE: This is not recommended as it will appear as an empty hyperlink in case the voucher is not available.

Adding Boleto as a Payment Method for a Customer 

You can add Boleto as a payment method for a customer. Make sure you have configured Boleto as a payment method in the Stripe gateway configuration. Only one Boleto payment method can be added per customer.

Follow the steps below to add the payment method:

1. Go to Customers and click on a customer name to navigate to the details page.

2. Under the Payment Methods section, click Add Payment Method and select Add Boleto.

   

3. Enter the required customer details and click Submit.

   

You can see the payment method added under the Payment Methods section.

How Can a Merchant Send a Boleto to a Customer? 

If a customer requests a Boleto from a merchant in case they lose their voucher or in any other scenario, a merchant must be able to send the Boleto to a customer on demand.

In such cases, a merchant can send the Boleto as a part of the invoice email. They can use the Send Invoice email option at the invoice level to send the invoice to the customer in the email with the link to the Boleto voucher.

Frequently Asked Questions (FAQs) 

Q1. How many active Boleto vouchers can exist for an invoice?
Ans. Only one active voucher can exist per invoice.

Q2. In which state of an invoice can a Boleto voucher be created?
Ans. A Boleto voucher can be generated only for the invoices in PAYMENT_DUE, NOT_PAID, and POSTED states.

Q3. What are the conditions for creating a voucher during subscription renewal, subscription creation, or adding a charge?
Ans. The following conditions are to be met for creating a voucher under these scenarios:

1. Auto-collection should be off.
2. The Invoice amount should be in BRL currency.
3. For subscription renewal/ subscription creation, the voucher will be created if the subscription's preferred offline payment method is Not selected, NO_PREFERENCE, or BOLETO.

Q4. When does Chargebee create a transaction if the customer pays using Boleto?
Ans. The transaction is created only when the customer completes the payment and Chargebee receives confirmation from the gateway. In case the customer does not complete the payment, a failed transaction will be recorded at Chargebee based on the webhook received from the gateway.

Q5. What if a customer makes a partial payment using any other payment method after a Boleto is issued?
Ans. If the invoice is partially paid using any other payment method after the voucher has been issued before the customer starts the Boleto payment, the Boleto is attached to the invoice and the leftover amount is considered as excess payment.

Q6. What if a customer makes a full payment using any other payment method after a Boleto is issued?
Ans. If the invoice is paid using any other payment method after the voucher has been issued before the customer starts the Boleto payment, the Boleto payment is considered as excess payment.

Q7. What happens to the Boleto payment if the invoice is adjusted due to a change in a subscription?
Ans. If the invoice is adjusted due to scenarios such as a change in a subscription after the voucher has been issued before the customer starts the Boleto payment, the Boleto payment is considered as an excess payment.

Q8. Can I generate a Boleto voucher?
Ans. If the customer selects Boleto as the payment method during checkout, the voucher is displayed at the end of the checkout process. Additionally, the customer receives an email with the link to the voucher as well.