We have divided the process in two parts: the integration to request a Boleto Bancário for an order placed by a customer; and the integration to be notified when such Boleto Bancário is paid.
2.1. Customer orders a product a product at the online Store
The customer places an order and selects to pay with Boleto Bancário.
Online Store sends a Boleto Bancário request to PagBrasil along with the order information (order number, customer details and amount in Brazilian Real).
PagBrasil returns the link to view and print the Boleto Bancário.
Online Store generates a confirmation page with the order details including the link to print the Boleto Bancário.
2.2 Customer completes the payment
The customer pays the Boleto Bancário using their Internet Banking or by going to any bank branch in Brazil. He also may pay the Boleto Bancário at authorized payment processors, such as drugstores, supermarkets and post offices.
Every morning (Brasília time zone) the bank sends PagBrasil a detailed list of all Boletos Bancários paid on the previous day. If the merchant has Boleto Flash® activated for their account, this may occur multiple times a day.
PagBrasil sends an IPN (Instant Payment Notification via a webhook) with a detailed list of paid orders to the Online Store.
Online Store acknowledges the receipt of the list.
Online Store processes the orders and delivers the products purchased.
Important:
A Boleto Bancário is valid for a specific number of calendar days.
By default we have set all your Boleto Bancários to 5 calendar days.
You can alter this general setting at the PagBrasil Dashboard, menu Account > Settings. Alternatively, you can set an individual expiration period for any specific order via the corresponding API function (see item 4.1, parameter bol_expiration).
We strongly recommend that you send the end customer a payment reminder by e-mail including the boleto URL for every boleto that is about to expire and has not yet been paid.