Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela Conta de Cobrança
    1. Outras Ações / Ações relacionadas
  4. Tela Conta de Cobrança
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas

01. VISÃO GERAL

Esta atividade visa demonstrar como como Registrar boleto boletos via API para o Banco do BradescoBradesco, facilitando a integração de sistemas e a realização de cobranças eletrônicas.

02. EXEMPLO DE UTILIZAÇÃO

...

Ter realizado o cadastro no banco do Bradesco para  obter o ClientID.

Tooltip
onlyIcontrue
linkTextStrongtrue
appendIconadd-item
iconColororange

Para solicitar a criação de um Client ID, é necessário enviar um e-mail para [email protected] seguindo o modelo Cadastro de Client ID.

Toda comunicação de APIs do Bradesco com parceiros é feita utilizando o protocolo mTLS, sendo necessário o uso de um certificado digital. Existem regras específicas para os certificados digitais aceitos pelo Bradesco. Confira:

  • Deve seguir o padrão ICP-BRASIL do tipo A1
  • Tamanho mínimo de 2048 bits
  • Utilizar algum algoritmo RSA como o RSASHA 256, 384 ou 512
  • Data de validade/expiração deve ser superior a 4 meses e no máximo 3 anos

Data de validade a contar da data da solicitação de cadastramento ou renovação. Para fins de teste, o certificado usado no ambiente de homologação pode ser uma versão autoassinada. 

Autenticação com a API do Banco Bradesco requer as seguintes cifras:

• TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, e/ou Página 5 de 22
• TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

Verifique se o seu sistema operacional está preparado para essas cifras e, caso não esteja, providencie os ajustes necessários.

Image AddedLink de referência: Manual do Desenvolvedor - Como utilizar as open APIs do Bradesco


Utilizar o Banco Bradesco para cobrança.

Realizar Cobrança Eletrônica.

...

Painel
borderColor#808080
borderStylesolid
Deck of Cards
id001
effectTypefade
Card
labelConfiguração Cobrança Eletrônica.
titleConfiguração do Prazo Limite para Recebimento na Cobrança Eletrônica
effectTypefade

Aba Conta Cobrança

Insira no campo Banco a opção Banco Bradesco. Complete os demais campos.

Marque as Opções:

  • Gera Cobrança Eletrônica: habilita a aba CNAB.
  • Gera Cobrança por API: habilita a geração via API Bradesco

Complemente as demais informações conforme Configuração de Cobrança Eletrônica.

Image RemovedImage Added

Imagem 2 – Configuração de Cobrança Eletrônica

Card
label Registrar boleto via API para Banco Bradesco
title Registrar boleto via API para Banco do Brasil

Registrar boleto via API para Banco BradescoInsira no campo Banco a opção 237- Banco Bradesco.

Marque a opção Gera Cobrança por API e a opção Emite Boleto.

Preencha os outros campos seguindo a configuração de conta cobrança. Complete os demais campos com base no Grupo alvo

No documento Processo Pix Cobrança - Integração com Banco do Brasil, está descrito o grupo alvo.

Aviso

Para solicitar a criação de um Client ID, é necessário enviar um e-mail para [email protected] seguindo o modelo Cadastro de Client ID.

Toda comunicação de APIs do Bradesco com parceiros é feita utilizando o protocolo mTLS, sendo necessário o uso de um certificado digital. Existem regras específicas para os certificados digitais aceitos pelo Bradesco. Confira:

  • Deve seguir o padrão ICP-BRASIL do tipo A1
  • Tamanho mínimo de 2048 bits
  • Utilizar algum algoritmo RSA como o RSASHA 256, 384 ou 512
  • Data de validade/expiração deve ser superior a 4 meses e no máximo 3 anos

Data de validade a contar da data da solicitação de cadastramento ou renovação. Para fins de teste, o certificado usado no ambiente de homologação pode ser uma versão autoassinada. 

Autenticação com a API do Banco Bradesco requer as seguintes cifras:

• TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, e/ou Página 5 de 22
• TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

Verifique se o seu sistema operacional está preparado para essas cifras e, caso não esteja, providencie os ajustes necessários.

Link de referência: Manual do Desenvolvedor - Como utilizar as open APIs do Bradesco

Insira no campo Banco a opção 237- Banco Bradesco.

Marque a opção Gera Cobrança por API e a opção Emite Boleto.

Nota

A opção Gera Cobrança por API é habilitada apenas para o Banco Bradesco e Banco do Brasil.

Funcionalidade de registro via API funcionará apenas quando o cliente for responsável pela emissão do boleto. Para isso a opção Emite Boleto deve estar marcada.

Ao marcar a opção, a aba API também será habilitada, permitindo o cadastro de informações para comunicação com o Bradesco.

Image Added

Image RemovedImagem 3 - Parâmetro Gera Cobrança por API Habilitado.

Aba Boleto.

Campos a serem informados:

  • Padrão de Preenchimento
  • Boleto Modelo

Complete as demais informações conforme a necessidade.


Image RemovedImage Added

Imagem 4 - Configuração Boleto

Aba API

  • Ambiente: Indica qual ambiente do Banco Bradesco a aplicação irá se comunicar.
    • Produção: Produção é o ambiente real da aplicação, onde se utiliza o sistema no dia a dia. 

      Após ter concluído todos os testes com sucesso em ambiente de homologação,
      o próximo passo é solicitar as credenciais do ambiente de produção. Para isso, será necessário adquirir um certificado emitido por Autoridade certificadora, como: 
      Digicert, CertiSign, Serasa entre outras. Geralmente o certificado emitido pelas autoridades Certificadoras é disponibilizado em um arquivo formato .pfx
    • Homologação: Homologação é o ambiente utilizado para realizar testes na aplicação sem impactar os dados reais. 
  • Bradesco
    • Certificação SSL
      • Importar
    Certificado SSL
      • : O Certificado SSL deve ter padrão ICP-Brasil e ser do Tipo A1. Também é recomendado pelo banco Bradesco que no momento da aquisição do certificado SSL seja solicitado à empresa que irá gerar o novo certificado que forneça os arquivos de chave pública e privada no formato
      • .
    pem”
      • pem e
      • .
    cer”
      • cer, facilitando posteriormente o envio do arquivo
      • .
    pem”
      • pem ou
      • .
    cer” referente
      • cer referente a chave pública para o Bradesco.
    • Client key: Chave criptográfica privada usada para autenticar um aplicativo cliente em um sistema de autenticação e autorização.
    • Client Secret: É parte da credencial para identificar sua aplicação na API do Banco Bradesco. É obtida após enviar, por e-mail ao Bradesco, a chave pública do certificado SSL que será utilizado na comunicação com a API de registro de boletos híbridos.

Link de referência: Manual do Desenvolvedor - Como utilizar as open APIs do Bradesco

Imagem 4 - Aba API com campos para comunicação com Banco Bradesco.

Aba Conta de Cobrança

  • Nro. do Contrato: Numero do convênio. Informação disponibilizada pelo Banco Bradesco.

Image RemovedImage Added

Imagem 5 - Nro do Contrato


Aba Boleto.

Campos a serem informados:

  • Emitido pelo(a) Empresa
  • Padrão de Preenchimento
  • Boleto Modelo

Complete as demais informações conforme a necessidade.

PRECISA TROCAR OU EDITAR ESSA IMAGEM, NO CAMPO: EMITIDO PELO(A) ,MARCAR A OPÇÃO EMPRESA


Image RemovedImage Added

Imagem 5 -Boleto

Composition Setup
deck.tab.inactive.background = #FFED00
deck.tab.active.background = #FF9900

...