Banco do Brasil
How it works
- After choosing the product in the merchant, the shopper selects the payment method Registered Boleto Banco do Brasil;
- The checkout will display the Boleto URL;
- The client accesses the URL (rendering) and can make the payment.
Attention
- Status reconciliation is not available for Checkout Cielo;
- The merchant must manually reconcile the boleto payment.
Registration and configuration with Banco do Brasil
BB Environment
To enable the Registered Boleto product, contact the Banco do Brasil relationship manager and provide the information below:
| Data | Format |
|---|---|
| URL (site) return to merchant | https://www.pagador.com.br |
| Return file format | (X) CBR643 |
| Return method | (X) Mainframe – for companies with their own system, not using GFN. |
Upon completing the registration, the merchant will receive a document.
2. Obtain credentials on the Banco do Brasil portal
Access the Banco do Brasil portal to obtain your credentials and follow these steps:
• Create registration on BB portal;
• Create an application (Billing API);
• Perform tests and send to production.
3. Register credentials
To use the BancoDoBrasil3 provider, it is mandatory to register the credentials below with Cielo support:
| Field | Value |
|---|---|
| Affiliation Signature | AppKey |
| Username | ClientId |
| Password | ClientSecret |
Boleto configuration at Cielo
Registration data
You must inform Cielo support the following data:
Data | Description | Format | Notes |
|---|---|---|---|
Agency | Agency code | 4 digits | Only the four agency numbers are required, without including the check digit. |
Account | Checking account | 7 digits | Hyphen required. |
Wallet | Wallet number and variation* | 5 digits in the format “XX/XX” | Example: “17/27”. |
Agreement | E-commerce agreement | 6 digits | It is the same value as Reconciliation (Billing Agreement) provided by the bank. |
Our Number | Boleto number that allows its identification with BB. It is an incremental counter. | 5 digits | Enter "10000" - With each boleto issued, this number increases by +1. |
Due Date | Boleto validity period | 2 digits in the format “XX” | It is the default value if no other value is sent via API. |
Instructions | Information displayed on the boleto | 50 digits | Only numbers and letters A-Z, no special characters or more than one space between each word. |
AppKey | Affiliation signature provided by Banco do Brasil. Available on the BB portal. | 32 digits | Hexadecimal sequence. |
ClientId | Identifier at Banco do Brasil | — | Credential provided by Banco do Brasil. |
ClientSecret | Key at Banco do Brasil | — | Credential provided by Banco do Brasil. |
*Wallet variation for Banco do Brasil: parameter for grouping boletos within the same wallet, allows the merchant to group its boletos according to different business models (branches, points of sale, etc.).
The merchant must send in the API contract the data (shopper name, CPF, and full address).
Boleto reconciliation
AT THIS TIME, THE REGISTERED BOLETO BANCO DO BRASIL DOES NOT PERFORM AUTOMATIC STATUS UPDATES.
Updated 3 days ago