Bradesco

O conector Bradesco permite a integração com as APIs do Banco Bradesco para operações bancárias, seguros e serviços financeiros.

Pré-requisitos

Para utilizar o conector Bradesco, você precisa:

1. Certificado A1 - Certificado digital para autenticação mTLS
2. Client ID e Client Secret - Credenciais geradas no portal do Bradesco usando o certificado

Importante

O mesmo certificado usado para gerar as credenciais (Client ID e Client Secret) no portal do Bradesco deve ser usado na configuração do conector. Usar um certificado diferente resultará em erro de autenticação.

Gerando o Certificado (Sandbox)

Para o ambiente de sandbox/homologação, você pode gerar um certificado A1 auto-assinado usando o OpenSSL:

openssl req -x509 -newkey rsa:2048 -nodes \
  -keyout key.pem \
  -out cert.pem \
  -days 365 \
  -subj "/C=BR/O=SuaEmpresa/CN=SuaEmpresa Ltda - 00.000.000.0001-00"

Campos do Subject (-subj):

Campo	Descrição	Exemplo
C	País (Country)	BR
O	Organização	SuaEmpresa
CN	Common Name (Razão Social + CNPJ)	SuaEmpresa Ltda - 00.000.000.0001-00

Exemplo completo:

# Substitua pelos dados da sua empresa
openssl req -x509 -newkey rsa:2048 -nodes \
  -keyout key.pem \
  -out cert.pem \
  -days 365 \
  -subj "/C=BR/O=Abstra/CN=Abstra Ltda - 37.405.458.0001-30"

Isso gerará dois arquivos:

• cert.pem - Certificado público (usar no portal e no conector)
• key.pem - Chave privada (usar apenas no conector)

Gerando as Credenciais no Portal Bradesco

1. Acesse o Portal de Desenvolvedores do Bradesco
2. Faça login ou crie uma conta
3. Crie uma nova aplicação
4. Faça upload do certificado (cert.pem) gerado anteriormente
5. Anote o Client ID e Client Secret gerados

Atenção

Guarde o Client Secret em local seguro. Ele não será exibido novamente.

Configuração do Conector

Campo	Descrição
Ambiente	Selecione Produção ou Sandbox
Client ID	Client ID gerado no portal do Bradesco
Client Secret	Client Secret gerado no portal do Bradesco
Arquivo de Certificado	Upload do arquivo cert.pem
Arquivo de Chave Privada	Upload do arquivo key.pem

Certificado para Produção

Para o ambiente de produção, você deve usar um certificado A1 emitido por uma Autoridade Certificadora (CA) válida, não um certificado auto-assinado.

Requisitos do certificado para produção:

• Emitido por uma CA reconhecida (ICP-Brasil)
• Validade mínima de 2 meses e máxima de 3 anos
• Razão Social + CNPJ no campo CN (Common Name)

Troubleshooting

Erro: "SSL with client authentication is required"

Causa: O certificado usado na requisição é diferente do certificado usado para gerar as credenciais.

Solução: Certifique-se de usar o mesmo certificado que foi cadastrado no portal do Bradesco ao gerar o Client ID e Client Secret.

Erro: "The given client credentials were not valid"

Causa: Client ID ou Client Secret incorretos.

Solução: Verifique se as credenciais foram copiadas corretamente do portal do Bradesco.

Erro: "Certificate has expired"

Causa: O certificado expirou.

Solução: Gere um novo certificado, cadastre no portal do Bradesco e atualize as credenciais.

APIs Disponíveis

Para a lista completa de ações disponíveis, consulte a documentação do conector no Console do Abstra.