Cobrança BolePix Banco do Bradesco
Para adesão, obtenção de credenciais e configuração de Webhooks no Banco do Bradesco, siga os passos a seguir:
Obtenção do Certificado
Para implantação do serviço, será necessária a compra de um certificado digital. Você poderá obtê-lo através de autoridades certificadoras validadas, acesse Banco Central do Brasil - Comunicação eletrônica de dados no sistema financeiro para mais informações.
É de responsabilidade do cliente a compra e o envio do certificado ao banco.
ATENÇÃO: o Certificado Digital deve ser do tipo e-CNPJ A1.
Acesso ao Portal e Criação da Aplicação
01. Acesse o Portal Developers Bradesco e crie seu cadastro:
https://developers.bradesco.com.br
Faça login com suas credenciais
Informe seus dados de acesso para entrar ou completar seu cadastro.
Na tela de login, você normalmente verá:
Campo de e-mail
Campo de Senha
Botão de acesso / “Entrar”
02. Acesse o Painel de Aplicações
Após o login, você será direcionado ao Portal Developers Bradesco, onde poderá gerenciar suas aplicações.
No Portal Bradesco Developers, clique em PRODUTOS no menu superior.
03. Localize a API
Na tela de produtos, busque e selecione o card Cobrança com QR Code.
Na página de detalhes do produto, clique no botão Inscrever-se (Inscrito +).
Pré-requisitos para uso em Produção:
Ser cliente pessoa jurídica Bradesco.
Ter contrato de cobrança ativo com o Bradesco.
Preencher a solicitação de assinatura
Na janela Solicitação de Assinatura:
Em Plano de Utilização, selecione o plano desejado Produção ou Sandbox. Em seguida, mantenha o time como Default Team.
Mantenha o Nome da Assinatura sugerido (ou ajuste se preferir).
Clique em Enviar Solicitação.
A assinatura ficará com status pendente. Você pode acompanhar o status pelo menu Assinaturas, à esquerda. Após a aprovação, será possível registrar sua aplicação para usar os recursos do produto. (o proximo maximo do Banco é 48 horas, porém normalmente é aprovado dentro de 4 horas)
04 Iniciar o registro
Depois que a assinatura for aprovada, volte à página do produto Cobrança com QR Code e clique no botão Registrar Aplicação.
Selecionar a aplicação
Na tela Registro de Aplicações (etapa 1. Selecionar Aplicação):
No campo Assinatura ativa
Selecione Cobrança com QR Code PRODUCAO [Nome da Empresa] – Default Team.
No campo Selecione uma aplicação para registrar, digite o nome da aplicação (ex.: Cobrança PIX QR Code) e clique em Criar para criar uma nova aplicação.
Na janela Criar Aplicação, preencha:
Nome (obrigatório) — ex.: Cobrança com QRcode – teste
Descrição (opcional) — ex.: Cobrança com QRcode
Imagem/Ícone (opcional) — aceita JPEG ou PNG até 5 MB
Seleciona a opção criar.
05 Selecionar Recursos
Marque os recursos (APIs) que a aplicação irá utilizar. Para habilitar o fluxo completo, marque o checkbox do cabeçalho para selecionar todos de uma vez.
Confira o contador Recursos selecionados e clique em Próximo.
Revisar e Enviar:
Confira as informações gerais e a lista de recursos vinculados.
Clique em Registrar Aplicação.
Solicitar Print
06 Confirmação e solicitação de Credencial
Será exibido o pop-up "Aplicação registrada com sucesso!" com o resumo do registro (recursos selecionados e aprovados).
Clique em Solicitar Credencial para gerar o Client ID e o Client Secret da aplicação, que serão usados para autenticação nas chamadas da API.
Solicitar Credencial
Na janela Solicitar Credencial, preencha os campos conforme abaixo:
Nome: informe um nome para a credencial (ex.: Cobrança com QR Code).
Qual recurso você deseja acessar? selecione o recurso:
Cobrança com QR Code – Registro de boleto com QR Code
Em qual aplicação você deseja adicionar a credencial? selecione o seu aplicativo (ex.: API PROD BOLEPIX - 0506).
Tipo: selecione a opção Modelo de autenticação mTLS.
Selecione a operação:
Nova credencial — para uma nova solicitação.
Renovação certificado — quando for necessário renovar.
Dados do Certificado:
CNPJ: informe o CNPJ da empresa.
Company Name: informe a razão social da empresa.
Certificado Público (formato .pem, .cer ou .crt): anexe o certificado público, conforme orientação a seguir.
7. Aguardar o processamento da credencial
Após enviar a solicitação, será exibida a mensagem "Sua solicitação de credencial será processada em breve." Clique em Fechar ou em Visualizar credencial.
Em seguida, você receberá uma notificação para aguardar a criação da sua credencial.
Importante:
O tempo limite de habilitação da credencial é de até 10 minutos.
Você pode verificar o status da credencial no menu lateral esquerdo.
Caso necessário, entre em contato com o suporte do Bradesco.
No menu lateral esquerdo, clique em Credenciais.
Na lista, localize e clique sobre o nome da credencial que foi criada (ex.: Cobrança com QR Code).Será aberto o painel Detalhes da Credencial, exibindo o Estado (ATIVO), a Aplicação vinculada e o bloco Valor da Credencial, com:
Client ID
Client Secret (clique para visualizar)
Copie e guarde esses dados em local seguro eles serão usados para autenticação nas chamadas da API.
ATENÇÃO: Por questões de segurança, o Client Secret fica visível somente por 3 dias. Caso o perca, será necessário gerar uma nova credencial para obter um novo Client Secret.
08 Solicitar o cadastro do Webhook PIX.
Entrar em https://drive.google.com/file/d/1hTLX1uwR3cBadUFCMfa8v1d3szTE9CU9/view?usp=drive_link e fazer o download do certificado em TXT.
Tendo em mãos o certificado SSL, escrever um e-mail no padrão abaixo para o endereço: governancaapis@bradesco.com.br , em cópia o endereço: implantacoes.theke@esales.com.br , anexando o certificado .
Assunto do e-mail: "CADASTRO DE CERTIFICADO DE WEBHOOK PIX - {Razão social}".
"Olá,
Peço a gentileza de efetuar o cadastro do certificado SSL em ANEXO para Webhook PIX.
CNPJ: {Preencher com o CNPJ da Empresa}
EMPRESA: {Razão social da Empresa}
Client ID: {Preencher com o seu Client ID da empresa, referenciado no item 07}".