Payment-method icon

Boleto Bancário Component integration

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

This page explains how to add Boleto Bancário to your existing iOS Components integration.

Requirements

Select the server-side flow that your integration uses:

API reference

Select which endpoint you are using:

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.

Set up webhooks

With Boleto, the shopper can pay more or less than the original amount. Set up standard webhooks to make sure that you know the amount that the shopper paid.

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