Boleto Híbrido Bradesco

Agora você pode gerar boletos que podem ser pagos tanto com código de barras quanto com QR Code Pix. Para utilizar os boletos híbridos do Bradesco integrados à Shipay, siga os passos abaixo:

Antes de começar: requisitos importantes para configurar o Boleto Híbrido

Antes de iniciar o passo a passo desta FAQ, é essencial que você tenha em mãos todas as informações e documentos necessários para realizar a configuração corretamente.

 1. Contrato do Boleto Híbrido:
Certifique-se de que o serviço de Boleto Híbrido já está contratado e ativo com a Shipay.
Sem essa contratação, o processo de configuração não poderá ser concluído.

 2. Certificado Digital emitido por uma certificadora:
É obrigatório utilizar um certificado digital válido, emitido por uma autoridade certificadora reconhecida (AC).

Atenção: não utilize certificados autoassinados, pois eles não são aceitos para este tipo de integração e podem impedir o funcionamento correto da emissão e liquidação dos boletos. Ressaltamos que não devem ser colocadas senhas no certificado.

3. Gerar a chave PIX, seguindo o passo a passo disponível em nosso FAQ específico do PIX Bradesco.
 Acessar o FAQ PIX Bradesco

Observação importante:
Após gerar a chave PIX, é necessário solicitar ao gerente do Gcash que vincule a chave PIX gerada à Shipay no convênio do cliente.
Esse vínculo é essencial para que os recebimentos via PIX funcionem corretamente na integração.

Contratação do Boleto com QR code 

Para ambos os casos, tanto para você, cliente que já utiliza a modalidade de cobrança do Bradesco, quanto para você que nunca a utilizou, é necessário acessar o link abaixo e seguir o passo a passo do vídeo para contratação:

Bradesco Explica – Contratação de cobrança | Net Empresa

Alteração para Cobrança Híbrida

Para clientes que já utilizam a cobrança e desejam alterar para a modalidade híbrida, a mudança só pode ser feita no Portal do Desenvolvedor se a contratação inicial da cobrança tiver sido realizada através deste canal.

Acesso e Contratação:
Acesse a plataforma do Portal do Desenvolvedor com seu login e senha:


Em seguida procure a seção “Produtos” como mostra a imagem abaixo:

Quais são as etapas para utilizar o ambiente de produção?

O processo é dividido em três etapas:

1. Assinatura – Solicitar acesso ao produto desejado.
   
   
2. Aplicação – Criar ou selecionar uma aplicação para associar ao produto.
   
   
3. Credencial – Solicitar e obter a credencial de acesso.
   
   Importante: os formatos de certificados aceitos são: .cer, .pem ou .crt, ou seja, certificados que não utilizam senhas.

1. Assinatura:

Como realizar a assinatura de um produto?

Pesquise pelo produto “Cobrança com QR Code” desta forma:



Após selecionar o ícone “Cobrança com QR Code” clique em “Inscrever-se” para efetuar a assinatura no produto selecionado:

Preencha as informações solicitadas selecionando o plano “Produção” e informe o grupo de trabalho que será responsável pela assinatura e defina um nome para a assinatura, deste modo:



Clique em "Enviar Solicitação" e aguarde a aprovação.

2. Aplicação

Como registrar uma aplicação?

Dentro do produto “Cobrança com QR Code”, clique em "Registrar Aplicação":

Faça com todos os recursos abaixos:

Cobrança - Cadastro de Webhook - Cobrança com QR Code

Cobrança com QRCode - Alteração de boleto com QRCode - Cobrança com QR Code

Cobrança com QRCode - Consulta e Segunda via de Boletos - Cobrança com QR Code

Cobrança com QRCode - Registro de boleto com QRCode - Cobrança com QR Code

Cobrança - Solicitação de baixa de boleto. - Cobrança com QR Code

Observação: a mesma aplicação pode ser utilizada para todos os recursos do produto.

Selecione a aplicação já criada, confirme e aguarde a aprovação.
Caso não possua uma aplicação criada, basta clicar em “Criar Nova Aplicação”. 

Após registrar todas as aplicações, você vai receber essa página em cada vez que registrar as aplicações

Além de fazer o processo no produto cobrança com Qrcode, também precisa fazer o processo no produto Cobrança.

Volte em “Produtos” e selecione a opção “Cobrança” como mostra abaixo:

No momento de registrar a aplicação você deve escolher o recurso:

Cobrança - Consulta de boleto específico e emissão de 2ª via - Cobrança

Importante: Sua assinatura irá para validação do Gestor de APIs do Bradesco. Se estiver tudo certo com os pré-requisitos em até 2 dias úteis sua assinatura será aprovada.
 

Para acompanhar a validação das suas assinaturas 

3. Credencial:

Como solicitar uma credencial?

Certificado Digital emitido por uma certificadora:

É obrigatório utilizar um certificado digital válido, emitido por uma autoridade certificadora reconhecida (AC).

Atenção: não utilize certificados autoassinados, pois eles não são aceitos para este tipo de integração e podem impedir o funcionamento correto da emissão e liquidação dos boletos.

Primeiro passo, você precisa exportar o Certificado Público A1

Página 1:

Página 2:

Após exportar o certificado, volte na página, clique em "Solicitar Credencial"

Informe os dados da aplicação, ambiente de Produção e tipo de chave.

Nesse momento você irá utilizar o certificado que exportou anteriormente:

Após criar a credencial, irá para análise e o banco vai validar os dados.

Após os 10 minutos, clique no menu lateral esquerdo de credenciais para validar se a credencial está ativa

Assim que clicar em visualizar credencial, você terá acesso da seguinte maneira:

Importante: Caso o produto possua mais de 1 recurso, você poderá atrelar os demais recursos na mesma aplicação e utilizar a mesma credencial.

Dúvidas frequentes:
Qual o prazo para utilização das credenciais?
Após a aprovação, você tem até 3 dias para baixar e utilizar as credenciais.
Depois desse prazo, será necessário solicitar novamente.

Posso utilizar a mesma credencial para mais de um produto?
Sim, desde que o produto e a aplicação estejam associados à mesma credencial e dentro das regras da plataforma.

O que fazer se minha credencial expirar ou não for habilitada?

Você deverá solicitar uma nova credencial pelo mesmo processo de solicitação anterior.

Configuração na Shipay

Agora realizaremos o cadastro no painel Shipay, para isso siga os passos:

• Faça login no painel: https://painelv2.shipay.com.br
• Vá na aba ‘Pix’ e adicione o certificado.

Você deverá adicionar as credenciais chave privada e certificado público do seu certificado MTLs relacionado ao CNPJ em questão.

Adicione:

• Nome do Certificado para identificado posteriormente.
  Provedor PSP: Bradesco 
• Descrição do certificado: (Exemplo: Certificado Boleto Híbrido Bradesco)
• Conteúdo da chave privada (arquivo “.pem”) e Conteúdo do certificado público (arquivo “.cert” ou “.crt”): Lembre-se de adicionar o certificado completo e tome cuidado para não adicionar espaços ou caracteres a mais.

Observação: No certificado da Shipay, você irá colocar os dados á partir do “-----BEGIN CERTIFICATE-----” até o “-----END CERTIFICATE-----” Caso tenha dados acima do BEGIN CERTIFICATE não é para colocar nos campos. 

Agora que está tudo preenchido, clique no botão Cadastrar e se tudo estiver certo com seu certificado você verá uma mensagem que configuramos o certificado com sucesso e então você verá seu certificado cadastrado:

• Vá na aba ‘Pix’.
• Selecione a card do Bradesco.
• Selecione a opção ‘Boleto híbrido’.

Preencha as informações:

Atente-se a seleção do certificado MTLs correto, previamente cadastrado no painel Shipay.

Boleto em arquivo PDF
Com este recurso, a Shipay possibilita a geração do boleto híbrido em formato PDF. Ele é indispensável caso o seu sistema de automação não ofereça suporte para confecção de boletos e também pode atuar como uma solução de contingência, garantindo a continuidade do serviço caso o sistema fique indisponível.
Basta preencher o modal de informações de cadastro do boleto híbrido e posteriormente preencher as seguintes informações:

Caso tenha pulado essa etapa inicialmente ou queira adicionar posteriormente, basta acessar a aba “PIX” procurar pelo botão de “Configurações” e em seguida clique para adicionar na opção “Boleto em arquivo PDF” como mostram as imagens seguir:

Após o preenchimento das informações, basta clicar em “Adicionar” para concluir o processo!

Vale lembrar que, para adicionar posteriormente, será necessário ter o boleto híbrido previamente cadastrado. Caso não tenha, primeiro, será necessário adicionar o boleto híbrido e, posteriormente, o boleto em PDF.

Obs: Caso precise editar alguma destas informações posteriormente basta clicar no botão “editar” que será disponibilizado no mesmo campo de “configurações”.

Informações Adicionais Importantes
Obrigatoriedade de Cadastro de Beneficiário:

O beneficiário deve estar parametrizado como "cobrança online" para a API funcionar corretamente. Essa configuração deve ser feita pelo gerente da conta.

Prazo de Geração de Boletos:
Após a configuração, os boletos poderão ser emitidos diretamente pelo sistema integrado (como PDV ou ERP).
Lembre-se de entrar em contato com o seu sistema de PDV e questionar se o mesmo está habilitado para geração do boleto em PDF.

Se você encontrar dificuldades ou tiver dúvidas em qualquer etapa do processo, nossa equipe está à disposição para ajudar:
E-mail: ajuda@shipay.com.br
WhatsApp: +55 11 94941-8625

Estamos prontos para ajudar você a configurar seus boletos integrados à Shipay!