Payment-method icon

Boleto Bancário Component integration

Add Boleto Bancário to your existing iOS Components integration.

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:

API reference

Select which endpoint you're integrating:

This is the default with iOS Components v5.0.0 or later.

Parameter name Required Description
shopperName -white_check_mark- The shopper's first name and last name.
socialSecurityNumber -white_check_mark- The shopper's Cadastro de Pessoas Físicas (CPF) number or their Cadastro Nacional da Pessoa Jurídica (CNPJ) number.
billingAddress -white_check_mark- The postal address of the shopper. Recommended to increase conversion rates.
deliverAt
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.
shopperEmail The shopper's email address. This is used for sending the shopper a copy of the payment form.
shopperStatement 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.

Component configuration

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:

v4.x.x

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.

  1. Log in to your test Customer Area.
  2. Go to Transactions > Offers.
  3. Select the PSP reference of the pending Boleto payment.
  4. 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.

Before you can accept live Boleto Bancário payments, you need to submit a request for Boleto Bancário in your live Customer Area.

See also