Bradesco (237): boleto, Pix, extrato e transferências
A integração mais ampla do Hap. Como assinar os produtos no portal Bradesco Developers, converter o certificado A1 da empresa em .crt e .key pela aba Certificado PEM, e as duas armadilhas do Bradesco: o Client Secret que fica visível por apenas 3 dias e a credencial de Pix que é separada da de Cobrança.
Quando usar
Use ao configurar a conta Bradesco pela primeira vez, ao perder o Client Secret, ou quando o Pix não funcionar mesmo com o boleto registrando normalmente.
Antes de começar
- Conta cadastrada no portal Bradesco Developers, com os produtos assinados.
- Certificado digital A1 da empresa, o mesmo usado na nota fiscal, em arquivo .pfx com a senha.
O que essa integração faz
O Bradesco é a integração mais completa do Hap: é o único banco que cobre todos os recursos. Boleto comum e híbrido, Pix em todas as formas, transferência por Pix, pagamento de boletos, extrato e saldo. São vários produtos no portal do banco, e você assina só os que for usar.
| Recurso | Como funciona |
|---|---|
| Boleto | Emitir, alterar, consultar e baixar. Também protesto e negativação pela API. |
| Boleto híbrido | Marque Boleto híbrido e o boleto sai com QR Code Pix. |
| Pix | Cobrança imediata e com vencimento, QR estático e devolução. Exige credencial própria. |
| Transferência por Pix | Por chave, agência e conta, CPF ou CNPJ, e-mail ou telefone. |
| Pagamento de boletos | Sim, em três etapas encadeadas que o Hap orquestra. |
| Extrato e saldo | Sim, usando a mesma credencial da cobrança. |
| Webhook | Registrado sozinho ao salvar a conta, para boleto, Pix e pagamento. |
Assinar os produtos e gerar a credencial
- 1
Cadastre-se no portal Bradesco Developers e ative a conta pelo e-mail.
- 2
Assine os produtos que for usar. O plano de sandbox é aprovado na hora; o de produção pode levar até 48 horas.
- 3
Registre uma aplicação, selecione os recursos e solicite a credencial, informando CNPJ, razão social e o certificado público.
- 4
Copie o Client Secret imediatamente. Ele fica visível por apenas 3 dias.
O certificado
O Bradesco autentica por certificado A1 da empresa - o mesmo da nota fiscal. Na conta bancária, abra a aba Certificado PEM, suba o arquivo .pfx com a senha e o Hap converte para os arquivos .crt e .key que o banco espera. Se você já tiver os arquivos separados, pode anexá-los direto no convênio. O mesmo certificado autentica boleto, pagamento e extrato.
Preencher o convênio no Hap
| Campo no formulário | O que preencher |
|---|---|
| Client ID (obrigatório) | O Client ID gerado no portal Bradesco Developers. |
| Client Secret (obrigatório) | O Client Secret gerado no portal. Copie na hora - some em 3 dias. |
| Ambiente (obrigatório) | Sandbox para testes ou Produção. |
| Arquivo .crt e .key (obrigatório) | O certificado convertido do A1 da empresa pela aba Certificado PEM. |
| Senha do certificado | Apenas se o certificado tiver senha. É gravada criptografada. |
| Boleto híbrido | Marque para o boleto sair com QR Code Pix embutido. |
Problemas comuns
- Perdi o Client Secret: não há como recuperar. O Bradesco o exibe por apenas 3 dias depois de gerado. Gere uma credencial nova no portal.
- O boleto registra mas o Pix não funciona: são credenciais diferentes. A de Cobrança atende boleto, QR Code, extrato e pagamento; Pix exige credencial própria, gerada à parte no portal.
- Erro de certificado ao emitir: o Bradesco exige o A1 da empresa em mTLS. Converta o .pfx pela aba Certificado PEM da conta - ela gera o .crt e o .key no formato que o banco espera.
- Um pagamento de boleto parou no meio: o Bradesco faz o pagamento em três etapas encadeadas. Cada uma pode falhar com o próprio erro - confira o status do pagamento para ver em qual delas parou.
- Gerar boletos em lote mostrou títulos que não foram emitidos: a tela lista o resultado de cada título. O Hap espaça as chamadas ao Bradesco e tenta de novo sozinho quando o banco avisa limite de requisições (Too Many Requests). Se ainda assim algum falhar, aguarde alguns segundos e clique em Emitir de novo: os que já saíram são pulados e os que falharam são reemitidos.
- Acesso proibido (403) logo depois de outras emissões funcionarem: costuma ser o limite de requisições do banco, não falta de liberação. Aguarde e tente de novo antes de abrir chamado com o gerente.