Conectar Bradesco

⏱ Tempo estimado: 30-60 minutos (envolve contato com o banco)

O Bradesco é o segundo maior banco privado do Brasil. Usa OAuth2 + mTLS seguindo o padrão do Banco Central.

Requisitos

Conta PJ no Bradesco
Contrato de cobrança ativo (indicadores 175 e 182 habilitados)
Certificado digital (ICP-Brasil ou emitido por AC reconhecida)
Chave Pix cadastrada na conta

⚠️Se não tem certeza sobre os indicadores 175/182, entre em contato com seu gerente de conta Bradesco.

Obter certificado digital

Se já tem certificado ICP-Brasil (A1):

bash

# Extrair certificado
openssl pkcs12 -in certificado.pfx -clcerts -nokeys -out certificado.pem

# Extrair chave privada
openssl pkcs12 -in certificado.pfx -nocerts -nodes -out chave.pem

Se não tem, pode gerar um certificado autoassinado apenas para homologação:

bash

openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -nodes \
  -subj "/CN=Sua Empresa LTDA/O=Sua Empresa/C=BR"

⚠️Para produção, use certificado ICP-Brasil A1 ou emitido por AC reconhecida. O Bradesco NÃO aceita certificados autoassinados em produção.

Solicitar credenciais ao Bradesco

Homologação

Envie email para suporte.api@bradesco.com.br com:
- Razão social e CNPJ da empresa
- Chave pública do certificado (arquivo .cer/.crt/.pem — APENAS a parte pública)
- Informar que deseja credenciais para API Pix em homologação
O Bradesco retornará: Client ID e Client Secret

Produção

Envie email para suporte.api@bradesco.com.br com:
- Chave pública do certificado de produção
- Contrato assinado (o Bradesco enviará o contrato pra assinatura)
O processo de inclusão em produção ocorre 2x por semana (terças e quintas)
Credenciais de produção são enviadas no dia útil seguinte

Cadastrar chave Pix

No Internet Banking Bradesco PJ, cadastre uma chave Pix
Pode ser CNPJ, email, telefone ou aleatória
Copie e guarde a chave

Conectar no Hubpay

Acesse hubpay.dev/dashboard/psps
Clique em Conectar novo PSP
Selecione Bradesco
Selecione o ambiente:
- Test = homologação
- Live = produção
Preencha:
- Client ID: fornecido pelo Bradesco
- Client Secret: fornecido pelo Bradesco
- Chave Pix: cadastrada no Bradesco
- Certificado (.pem): conteúdo do certificado
- Chave Privada (.key): conteúdo da chave privada
Clique em Salvar credencial

💡🔒 Credenciais e certificado criptografados com AES-256-GCM.

⚠️Certificados de homologação e produção devem ser diferentes.

Configurar webhook

Após salvar, siga as instruções na tela.

Testar

bash

curl -X POST https://api.hubpay.dev/v1/charges \
  -H "Authorization: Bearer hpx_test_SUA_CHAVE_HUBPAY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "provider": "bradesco",
    "description": "Teste Bradesco"
  }'

Solução de problemas

Erro	Causa	Solução
`502` com "SSL" ou "mTLS"	Certificado inválido	Confirme que usou o certificado correto pro ambiente (homologação vs produção).
`502` com "OAuth 401"	Client ID/Secret incorretos	Verifique credenciais. Atenção: o Bradesco envia client_id e secret no body, não Basic Auth.
`502` com "chave Pix"	Chave não cadastrada	Cadastre chave Pix no Internet Banking Bradesco PJ.
"Certificado expirado"	Certificado venceu	Renove e envie novo pro Bradesco via suporte.api@bradesco.com.br.
"Contrato não ativo"	Indicadores 175/182 não habilitados	Solicite ao gerente de conta.
Credenciais de produção demoram	Processo é 2x/semana	Envie contrato assinado + certificado até terça 14h pra inclusão na quinta.

Comparação com outros PSPs que usam mTLS + padrão BCB

Aspecto	Efí	Inter	Sicredi	Sicoob	Bradesco
Certificado	Gerado pelo Efí	Gerado pelo Inter	Gerado pelo Sicredi	ICP-Brasil A1	AC reconhecida ou ICP-Brasil
Client Secret	Sim (Basic Auth)	Sim (body)	Sim (Basic Auth)	Não	Sim (body, não Basic Auth)
Processo credenciais	Autoatendimento	Autoatendimento	Autoatendimento	Portal + agência	Email + contrato
Tempo pra produção	Minutos	Dias	Dias	Dias	Terças/quintas
API Pix	Padrão BCB	Padrão BCB	Padrão BCB	Padrão BCB	Padrão BCB

Links úteis

Portal API Bradesco
Bradesco Net Empresa
Suporte API: suporte.api@bradesco.com.br