On this page, you can find additional configuration for adding Boleto Bancário to your Components integration.
Before you begin
This page assumes you have already:
Select which endpoint you're integrating:
This is the default with iOS Components v5.0.0 or later.
|The shopper's first name and last name.
|The shopper's Cadastro de Pessoas Físicas (CPF) number or their Cadastro Nacional da Pessoa Jurídica (CNPJ) number.
|The postal address of the shopper. Recommended to increase conversion rates.
Checkout API v68 or later
|The due date of the payment, using ISO 8601 format in UTC. If this is in a weekend or national holiday, the shopper can pay the Boleto the next working day.
By default, the shopper has five days to complete the payment.
|The shopper's email address. This is used for sending the shopper a copy of the payment form.
|Free-text field with payment instructions. If you include this, make sure to state that you do not accept payments for a higher or lower amount than the original amount, or payments after the due date.
If you leave the
shopperStatement empty, it is populated with the following default Portuguese text:
|Não aceitar pagamento via cheque e/ou após a data do vencimento.
|Do not accept payment by cheque and/or after the due date.
|Seu pedido será enviado somente após a confirmação do pagamento deste boleto, desde que não tenha divergência de valores entre o valor cobrado e o valor pago.
|Your order will only be processed once the payment of this Boleto has been confirmed and as long as there is no difference between the payable and paid amounts.
|A falta de pagamento deste boleto não implica em qualquer multa ou juros e o pedido será automaticamente cancelado.
|Failure to pay this boleto will not incur any penalty or interest and your order will be automatically cancelled.
|Não deposite nem faça transferência.
|Do not pay by deposit or bank transfer.
v5.0.0 or later
If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the Boleto Bancário Component:
If your integration uses an earlier version of iOS Components:
There are no configuration steps specific to Boleto Bancário required for Components.
Test and go live
Boleto Bancário is an offline payment method.
In the test environment, you can simulate a Boleto payment by promoting the pending payment to a sale.
- Log in to your test Customer Area.
- Go to Transactions > Offers.
- Select the PSP reference of the pending Boleto payment.
- Select the Promote this offer to a sale button.
Check the status of Boleto Bancário test payments in your Customer Area:
- Boletos that are pending or that have expired are under Transactions > Offers.
- Boletos that have been paid (including test offers that you manually promoted to sale) are under Transactions > Payments.
Test the reconciliation process by promoting test payments from offer to sale in your test Customer Area.