Bradesco

ℹ️

Please refer to the API Reference for the full request and response examples.

How it works

  1. After selecting a product, the shopper chooses the Boleto Bradesco payment method;
  2. The merchant sends a request to Cielo calling the corresponding payment method;
  3. Cielo communicates with Bradesco’s application to request boleto registration;
  4. If the registration is successful, the bank responds with billing details (barcode, digitable line, etc.) and the Boleto URL;
  5. Cielo includes the link in the response so the merchant can open a pop-up displaying the boleto;
  6. The client accesses the boleto URL (rendering) and can then make the payment;
  7. Boleto reconciliation is performed through Cielo’s query service to Bradesco’s system;
  8. 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:

    ParametersData
    NotificaçãonumOrder=[%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çãonumOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]&
    FalhanumOrder=[%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çãonumOrder=[%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

  1. In the Bradesco panel, the merchant must go to the “Configurações” tab and select "Meios de Pagamento”.
  2. The “Palavra-secreta” field must be filled with a password. Confirm the operation by clicking “Gerar nova chave de segurança”.
  3. 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:

DataDescriptionFormatObservation

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.

CredentialsDescriptionExample

User

Email used to access the Bradesco Panel

[email protected]

Password/Security Key

Security key created within the Bradesco Panel.
It is not the password used to access 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”.