Skip to main content

Guia de Integração | Bradesco PIX

sgptsmx-petroleo.png

1. Introdução

A integração com APIs PIX para a emissão de cobranças representa um avanço estratégico para empresas que buscam automatizar e otimizar sua gestão financeira. Ao conectar diretamente o SGP às instituições bancárias, elimina-se a necessidade de processos manuais, como conciliações demoradas e verificações externas, garantindo agilidade e precisão na liquidação dos pagamentos.

Entre os principais benefícios dessa integração, destacam-se:

  • Automatização do processo de cobrança: o QR Code PIX é gerado e registrado automaticamente a partir do SGP, atendendo às regras do Banco Central e garantindo maior agilidade no processo.

  • Retornos instantâneos ou em 3 horas: a confirmação do pagamento ocorre em tempo real (ou em 3 horas, para retornos via rotina), permitindo atualização imediata dos recebimentos no sistema.

  • Redução de erros e inconsistências: a comunicação direta evita falhas comuns em processos manuais, como atrasos no reconhecimento de pagamentos ou divergências de valores.

  • Maior segurança e confiabilidade: os dados são transmitidos de forma padronizada e segura, reduzindo riscos de fraudes ou informações incorretas.

  • Controle centralizado: todas as movimentações financeiras ficam registradas no SGP, facilitando a conciliação e o acompanhamento da inadimplência.

Assim, a integração PIX via API não apenas simplifica o processo de cobrança, como também garante retornos rápidos, maior eficiência operacional, segurança e controle estratégico sobre o fluxo de caixa da organização.

Antes de iniciar o processo, consulte nossa FAQ – Atenção à Segurança da sua Integração! para garantir uma implementação mais segura e eficiente.

2. Dados necessários para integrar ao SGP

Para realizar a integração da API PIX do Bradesco, é necessário inicialmente gerar as credenciais de acesso no portal Bradesco Developers.

As credenciais usadas para integração devem geradas com auxilio do suporte do banco.

Durante esse processo, serão exigidos alguns dados e arquivos obrigatórios:

  • Client ID

  • Client Secret

  • Chave PIX

  • Certificado Digital A1 + Senha

Atenção ao Certificado Digital A1:
O certificado digital A1 utilizado na comunicação com o Bradesco deve possuir validade superior a 60 dias. Certificados com prazo inferior a esse limite serão automaticamente recusados pelo banco, impossibilitando a execução de operações, como emissão de cobranças ou consultas de retorno.

Assim, é essencial que a empresa mantenha um controle preventivo da validade do certificado, garantindo a continuidade da integração sem interrupções.

3. Cadastro do Gateway PIX

Com os dados em mãos, podemos integrar o Gateway ao SGP para emissão de PIX.

  • No Menu Principal, acesse Financeiro (❶), depois vá em Cadastros (❷) e, em seguida, clique em Gateway de Pagamento (❸).

Modelo_de_imagem_horizontal_com_sombra.png

Esse modelo de integração é apenas para emissão de QRCode PIX, caso queira uma integração de Boleto Hibrido, verifique a documentação correspondente!

Clique no botão Cadastrar e preencha da seguinte forma:

  1. Nome da Integração: Bradesco PIX
  2. Descrição
  3. Usuário: Client ID
  4. Senha: Client Secret
  5. Chave PIX: Chave PIX da conta Bradesco
  6. Habilite Pagamentos via PIX
  7. Selecione o Portador que deseja vincular o pix
  8. URL de Notificação: https://URL_DO_SGP/ws/notificacao/pix
  9. Insira o Certificado A1 e a senha

Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais

Imagem de Referência (API PIX)

bradesco pix.jpeg

4. Informações Adicionais
  • A URL de notificação deve obrigatoriamente utilizar o protocolo HTTPS. Caso ainda não possua um endereço com HTTPS, entre em contato com o suporte para verificar a possibilidade de aquisição de um subdomínio SGP.
  • Caso utilize dominio próprio é preciso enviar o certificado SSL ao banco para cadastro do Webhook
  • No cadastro da URL de notificação, o ID do Gateway é indispensável para o correto processamento dos retornos.
    • Para identificá-lo, siga os passos:
      • Crie um gateway deixando o campo “URL de notificação” em branco.
      • Anote o ID gerado.
      • Em seguida, cadastre a URL de notificação utilizando esse ID.
  • Para integrações que exijam uma rotina de processamento de retorno, é necessário acionar o suporte para que seja feita a configuração dessa rotina.
  • A integração do PIX Avulso pode ser vinculada a portadores locais ou portadores outros bancos que não tenham emissão de pix.

  • A seguir, listamos algumas funcionalidades disponíveis para a sua integração:

Funcionalidade Bradesco PIX
PIX - Emissão ✔️
PIX - Cancelamento ✔️
PIX - Tempo de Baixa Rotina/Webhook
Parâmetros

pixvencimento=1 (habilitar cobv)

forcar_atualizacao_pix=1 (atualizar pix cob)
É cov ou cobv? ambos
PIX Híbrido ou Avulso? Avulso

 

Para essa integração existem dois tipos de PIX o  Pix Cob e Pix CobV :

  • Pix Cob : Gera um QR Code para pagamento imediato, sem data de vencimento. Ideal para pagamentos instantâneos e avulsos. Nessa modalidade, no SGP esse PIX expira no dia do vencimento do boleto.
    • Sendo possivel usar o parâmetro abaixo para gerar um novo pix atualizado após expirar. 
      forcar_atualizacao_pix=1

  • Pix CobV (Cobrança com Vencimento)  : Permite definir uma data de vencimento e aplicar juros, multas e descontos. Usado para cobranças recorrentes, como boletos. Nessa modalidade, no SGP o PIX acompanha o "vencimento" do boleto atualizando Multa e Juros diários. Pode ser habilitado com o uso do seguinte parâmetro:

    pixvencimento=1

Para usar os parâmetros acima é preciso verificar com o banco quais escopos estão ativos para a sua conta.

tsmx-petroleo.png

Back to top