Bradesco
Please refer to the API Reference for the full request and response examples.
How it works
- After selecting a product, the shopper chooses the Boleto Bradesco payment method;
- The merchant sends a request to Cielo calling the corresponding payment method;
- Cielo communicates with Bradesco’s application to request boleto registration;
- If the registration is successful, the bank responds with billing details (barcode, digitable line, etc.) and the Boleto URL;
- Cielo includes the link in the response so the merchant can open a pop-up displaying the boleto;
- The client accesses the boleto URL (rendering) and can then make the payment;
- Boleto reconciliation is performed through Cielo’s query service to Bradesco’s system;
- To receive payment notifications, the merchant must register a Notification URL or use the query service.
Configuring boleto
Bradesco environment
The merchant must perform configurations within the bank environment.
Control Panel
The merchant must contact the Banco Bradesco relationship manager to request the activation of Registered Boleto via API Manager/Control Panel.
The bank’s technical team will send the access credentials for the API Manager/Control Panel to the requester’s email.
BRADESCO Control Panel:
https://meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp
Configuring the boleto
In the Bradesco panel, the merchant must go to the “Configurações” tab, select “Meios de Pagamento”, and update the following configurations:
-
Habilitar "frase" do boleto: Inativo
-
Habilitar "referência" do boleto”: Ativo
-
Apresentar Agência e Conta: Inativo
-
Vencimento: 5 dias
The due date can be defined in Cielo products
-
URL de notificação:
https://www.pagador.com.br/post/BoletoBradescoSps/ReceivePost -
In the Chave de segurança field, click Gerar chave de segurança
-
Endereço IP da loja (numeric)
-
For the fields URL de resposta, URL de falha, and URL de redirecionamento, enter the following link:
https://www.pagador.com.br/post/BoletoBradescoSps/ReceivePost
For each of the three parameters below, fill in with the Communication Parameter shown below:
Parameters Data Notificação numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]&Confirmação numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]&Falha numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]&Comunicação numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]&
Tela de configuração geral de integração - Parâmetros de Comunicação
Não podem existir espaços ou quebras de texto nos parâmetros expostos acima.Click "Gravar todas as configurações realizadas"
Configuring Credentials
- In the Bradesco panel, the merchant must go to the “Configurações” tab and select "Meios de Pagamento”.
- The “Palavra-secreta” field must be filled with a password. Confirm the operation by clicking “Gerar nova chave de segurança”.
- Still in the Bradesco Panel, the client must create a Query User for status updates.
Bradesco support
Para obter ajuda com os passos acima, entre em contato com o suporte Bradesco.
Cielo environment
Registration Data
The merchant must provide Cielo support with the following information:
| Data | Description | Format | Observation |
|---|---|---|---|
Branch | Branch code | 4 digits | with or without hyphen |
Account: | Checking account | 7 digits | with hyphen |
Wallet: | Not required for registered boleto | 2 digits | N/A |
Reconciliation | Billing agreement number | 7 digits | Provided in the Bradesco control panel |
Agreement | E-commerce agreement | 6 digits | Validate with the bank if it is required for the wallet |
Our Number | Incremental counter | 5 digits | Optional – Control number that increases by +1 with each boleto issuance |
Due Date | Boleto validity period | 6 digits | This is the default value if no other value is sent via API |
Affiliation Signature | Bradesco security key | 50 digits | Provided in the Bradesco Panel |
Bradesco credentials will be required:
These credentials are used so that Cielo can query the boleto status.
| Credentials | Description | Example |
|---|---|---|
User | Email used to access the Bradesco Panel | |
Password/Security Key | Security key created within the Bradesco Panel. | qcnmFA-Y2rGm4meWLzrEzSpdPARBsmblZSqfKLwq7DM |
Suporte Cielo
If you have any questions at any stage or need additional technical information, contact Cielo Support
Status Update
For the Bradesco Registered Boleto payment method, status updates are performed via batch polling:
-
This polling occurs in the morning: 4 a.m., 6 a.m., 8 a.m., 10 a.m., and 12 p.m.
To receive payment notifications, the merchant must register the Notification URL along with performing GET requests.
Note: Currently, the polling process considers transactions with a due date within the range of 30 days before and 30 days after the polling date.
Status update is not available for Checkout and Link de Pagamento clients.
Manual Boleto Reconciliation
To reconcile the boleto manually, locate the order on the Cielo website and, within Transaction Details, find the “Reconcile” button. This action will change the order status from “Unpaid” to “Paid”.
Updated about 5 hours ago