API Bradesco – Integração de Cobrança (Boletos)
Este manual orienta o processo de configuração da API de cobrança do Bradesco no sistema, incluindo exportação de certificado, cadastro no portal e configuração de webhook.
Pré-requisitos
Antes de iniciar, é necessário:
-
Certificado digital A1 (.pfx) válido e instalado no computador;
-
Acesso ao portal de desenvolvedores do Bradesco;
-
Permissão no sistema para configurar portadores/webhooks.
Exportar Certificado Público. Para integração com o Bradesco, é necessário exportar o certificado público (sem chave privada).
Passo a passo:
- Pressione Win + R;
- Digite: certmgr.msc e pressione Enter;
- Localize o certificado digital da empresa;
- Clique com botão direito sobre ele: ◦ Todas as tarefas > Exportar;
- No assistente de exportação: > Selecione NÃO EXPORTAR A CHAVE PRIVADA > Escolha o formato Base64;
- Finalize a exportação.
Acesso ao Portal do Bradesco: O layout pode variar entre ambiente de desenvolvimento e produção.
Acesso: Api Banco Bradesco
Etapas:
- Criar conta ou acessar o portal;
- Localizar e se inscrever na API de: > Cobrança (Registro de Boleto). Atenção: Não selecionar opção com QR Code;
- Selecionar também: > Cadastro de Webhook;
- Solicitar credenciais: > Enviar o certificado público exportado.
Após aprovação será disponibilizado: Client ID e Client Secret. Esses dados devem ser inseridos no sistema Simdata.
Configuração de Webhook: O webhook permite que o sistema receba atualizações automáticas do Bradesco (pagamentos, baixas, etc). Envio obrigatório ao Bradesco:
Enviar e-mail para: governancaapis@bradesco.com.br
Com os seguintes dados em anexo:
- Certificado público (SSL);
- CNPJ da empresa;
- Razão social.
Renovação do Certificado: Sempre que o certificado digital for renovado se faz necessário seguir os passos abaixo:
1. Exportar novamente o certificado público
2. Reenviar para o Bradesco com:
- Certificado Digital;
- CNPJ da Empresa;
- Razão social.
Caso não seja feito, o sistema deixará de receber atualizações do banco.
Após concluir todas as etapas:
- Verifique se as credenciais estão preenchidas corretamente;
- Comunicar equipe Simdata que os dados estão preenchidos para que se possa validar o Webhook internamente;
- Confirme o recebimento de eventos via webhook;
- Realize testes de emissão e baixa de boletos.
Observações Importantes: A liberação das credenciais depende do Bradesco, o processo pode variar conforme ambiente (homologação/produção). Sempre manter o certificado atualizado.
