Como Habilitar o PIX Banco do Brasil V2

A integração do PIX do Banco do Brasil V2 ao Painel Veloce permite que sua empresa receba pagamentos de forma rápida, segura e totalmente integrada ao sistema.

Este guia apresenta o passo a passo completo para configurar a integração, desde a geração do certificado até a ativação no painel.


Pré-requisitos

Antes de iniciar a configuração, é necessário atender aos seguintes requisitos:

1. Certificado Digital A1

Para garantir segurança e autenticação na comunicação com o banco, será necessário:

  • Solicitar à contabilidade o Certificado Digital A1 do CNPJ vinculado à conta bancária que receberá o Pix.

  • Cadastrar uma chave Pix na conta (recomendamos chave aleatória para maior segurança).

2. Cadastro no Portal Developers BB

A integração é realizada através do portal oficial do Banco do Brasil, responsável pela gestão das APIs do Pix.

O usuário que realizará o cadastro deve ser representante legal ou outorgado da empresa

⚠️ Esta etapa é de responsabilidade do cliente.

Acesso ao Portal

Acesse: Portal Developers BB | Banco do Brasil

Clique em CADASTRE-SE e informe os seguintes dados:

  • CPF
  • Nome completo
  • Data de nascimento

  • E-mail
  • Celular

Após finalizar o cadastro, siga para a criação da aplicação Pix.

Criando a Aplicação PIX – Versão 2

Essa etapa permitirá que o sistema gere as credenciais necessárias para integração com o Painel Veloce.

Passo a passo:

1. Faça login no Portal Developers.

2. Clique em CRIAR NOVA APLICAÇÃO e preencha

  •  Nome da Aplicação (Obrigatório)
  • Descrição (Obrigatório)
  • Ícone (Opcional)

3. Na seleção de API, escolha PIX – Versão 2 e clique em CRIAR ao final da página.

 

Obtendo os certificados

Na aba Certificados você irá realizar o envio do Certificado Raiz e o Certificado da Empresa para extrair o .crt e o .key.

 

Após aprovação do banco, a aplicação estará pronta para gerar as credenciais de produção.

Obtendo as Credenciais de Produção

Após a aplicação ser aprovada e colocada em produção, selecione a aplicação criada no Portal Developers BB, acesse a opção Credenciais e, na aba Detalhes da aplicação, copie as credenciais exibidas. Essas informações deverão ser inseridas posteriormente no Painel Veloce para concluir a integração.

Gerando os Arquivos .crt e .key

Para que a comunicação com o Banco do Brasil funcione corretamente, é necessário gerar os arquivos crt.crt e key.key a partir do certificado digital A1 no formato .pfx.

 

Configurando o Painel Veloce

Acesse Configurações > Empresas, na aba Configurações e localize as opções de Pagamento PIX, selecione Banco do Brasil e preencha os campos Chave PIX BB, Chave API BB, Client ID e Client Secret, com as credenciais geradas no Banco do Brasil em seus respectivos campos:

Depois, realize o upload dos certificados CRT e KEY e, para concluir a integração, clique em Salvar.

 

Se precisar de apoio em qualquer etapa do processo, conte com o time Veloce para garantir que sua integração seja concluída com segurança e agilidade.

📲 Fale conosco pelo WhatsApp: https://wa.me/555131080066

E-mail de suporte: suporte@veloce.tech
Telefone: (51) 3108-0066
Base de conhecimento: cac.veloce.tech
Envie seu feedback ou sugestões: contato@veloce.tech