A integração do Pix com o Banco do Brasil permite que o sistema gere o QR Code diretamente no PDV e receba automaticamente a confirmação do pagamento realizado pelo cliente. Para que o processo funcione corretamente, é necessário configurar a conta bancária, criar a aplicação no Portal Developer do Banco do Brasil, informar as credenciais de acesso e vincular a conta a uma forma de pagamento Pix.

1. Configuração da conta bancária

O primeiro procedimento é cadastrar ou ajustar a conta bancária que será utilizada na integração. Essa configuração é responsável por identificar o Banco do Brasil e habilitar os campos específicos necessários para comunicação com o Pix.

No sistema, realize o seguinte procedimento:

1. Acesse a tela de cadastro de contas bancárias.
2. Informe uma descrição que facilite a identificação da conta, como Pix Direto Banco do Brasil.
3. No campo Banco, selecione 01 – Banco do Brasil.
4. Preencha, se desejar, os dados de agência, número da conta e respectivos dígitos.
5. Localize a opção de integração com Pix e altere para Sim.
6. Após a ativação, mantenha o cadastro aberto para posteriormente informar os dados da integração.

Os campos de agência, conta e dígitos não são obrigatórios para a integração, porém o preenchimento é recomendado para manter o cadastro bancário organizado e facilitar sua identificação.

2. Criação da aplicação no Portal Developer

Para que o sistema possa se comunicar diretamente com a API do Banco do Brasil, é necessário criar uma aplicação no Portal Developer e solicitar suas credenciais de produção.

Acesse o Portal Developer do Banco do Brasil utilizando um cadastro ativo e siga estas etapas:

1. Efetue o login no portal e selecione a opção para criar uma nova aplicação.
2. Informe um nome para a aplicação, como Integração Pix Sistema Web.
3. Utilize o mesmo nome no campo de descrição.
4. Na seleção de APIs, marque a opção Pix.
5. Role a página até o final e clique em Criar.
6. Após a criação, acesse a aplicação para visualizar seus detalhes.
7. Clique em Enviar para produção, localizado no canto inferior direito.
8. Na tela de Solicitação de Produção, clique em Próximo.
9. Revise as informações apresentadas e confirme em Solicitar produção.

Após a conclusão desse processo, deverão ser obtidas as credenciais que serão utilizadas na configuração da conta bancária no sistema.

3. Preenchimento das credenciais de integração

Com as credenciais disponibilizadas pelo Banco do Brasil, retorne ao cadastro da conta bancária configurada anteriormente. Nessa etapa serão informados os dados necessários para autenticação e comunicação segura com a API do banco.

Preencha os campos da integração da seguinte forma:

1. Selecione o certificado digital da empresa no formato PFX.
2. Informe a senha do certificado digital.
3. Preencha o Client ID gerado pelo Portal Developer.
4. Informe o Client Secret correspondente.
5. Preencha o código de acesso fornecido.
6. Informe a chave Pix da empresa. No exemplo utilizado no treinamento, a chave corresponde ao CNPJ da empresa.
7. Preencha os campos de usuário e senha utilizados no Portal Developer.
8. Clique em Salvar para concluir a configuração.

É importante conferir cuidadosamente as credenciais antes de salvar, pois esses dados serão utilizados pelo sistema durante a comunicação com o Banco do Brasil.

4. Vinculação da conta à forma de pagamento

Depois que a conta bancária estiver configurada, é necessário vinculá-la a uma forma de pagamento Pix. Essa associação permite que o PDV identifique qual conta deverá ser utilizada para gerar o QR Code durante a finalização da venda.

Para realizar a vinculação:

1. Acesse a tela de cadastro de formas de pagamento.
2. Informe uma descrição, como Pix Direto Banco do Brasil.
3. No campo de tipo da forma de pagamento, selecione Pix.
4. Ative a opção de integração QR Code Pix.
5. Nas contas disponibilizadas pelo sistema, selecione a conta do Banco do Brasil configurada anteriormente.
6. Clique em Salvar.

A partir desse momento, a forma de pagamento estará preparada para utilizar a integração direta com o Banco do Brasil.

5. Teste da integração na frente de caixa

Com todas as configurações concluídas, recomenda-se realizar uma venda de teste no PDV para validar a geração do QR Code e o retorno automático do pagamento.

Execute o teste da seguinte forma:

1. Inicie uma venda normalmente na frente de caixa (PDV) e adicione um produto.
2. Avance até a tela de finalização da venda.
3. Selecione a forma de pagamento Pix Banco do Brasil configurada anteriormente.
4. Aguarde o envio das informações ao banco e a geração do QR Code na tela do PDV.
5. Utilize o aplicativo bancário para escanear o QR Code e realizar o pagamento.
6. Aguarde o retorno da transação ao sistema.
7. Após a confirmação, verifique se o sistema reconheceu o pagamento e realizou a baixa da venda.
8. Clique em Finalizar venda para concluir a operação.

Em ambiente de homologação, caso a confirmação do pagamento apresente demora, utilize o botão Consultar para verificar diretamente na API do banco o status da transação. No ambiente de produção, o retorno do pagamento ocorre automaticamente após a confirmação realizada pelo banco.