Como Instalar o Módulo Banco do Brasil API Pix em sua loja Opencart?

Requisitos:
- Opencart 3.x
- Ter conta junto empresa Banco do Brasil (https://www.bb.com.br/)
- Ter Certificado digital e.CNPJ (PFX)
- Cadastro em ambiente https://acesso.bb.com.br/v2/login?appId=ipa-developers do Banco do Brasil
- PHP >= 5.6 / 7.x / 8.x

Métodos de pagamentos suportados:
- Pix via Banco do Brasil (requer conta empresa junto ao banco)

Como instalar:

1 - Primeiro, acesse sua conta em nossa loja (clique aqui) depois em Downloads baixe o arquivo de seu módulo e copie o seu serial de registro (mantenha o mesmo a salvo em seu HD ou cloud, só guardamos downloads de clientes por 6 meses), após baixado descompacte o arquivo do módulo.


2 - A instalação poderá ser feita por FTP (como usar o FTP), para instalação por FTP primeiramente acesse o servidor de sua loja via FTP, ao acessar acesse o diretório principal de sua Opencart (o qual fica as pastas de admin, catalog. etc) e envie todo conteúdo qual esta dentro da pasta "UPLOAD" (não é a pasta upload e sim o conteúdo da mesma) para  dentro do diretório principal de sua Opencart e aguarde a conclusão do Upload dos arquivos até a conclusão.

3 - Depois de enviados os arquivos por FTP acesse o Admin de sua loja Opencart e depois em Extensões > Modificações e clique em "Recarregar", ainda no Admin acesse Extensões > Pagamento e localize o módulo "Banco do Brasil API (pix)" e o instale.

 4 - Após instalado acesse as configurações do mesmo onde inicialmente deverá ativar a licença do módulo em sua loja (igual na tela abaixo), ao acessar caso exiba o campo pedido o serial apenas informe o mesmo e clique em salvar (copie o serial em sua conta em nossa loja no menu Downloads), ao salvar caso não exiba a tela de configuração clique aqui.

e clicar em ativar.

5 - Caso ative corretamente agora é só configurar o módulo com suas credenciais Banco do Brasil, configure os campos todos de forma correta e com dados válidos, origem dos campos customizados e status de situações de pedidos, feito isso salve as configurações.
Atenção: Lembrando que em cada campo vai ter instruções do tipo de informação a se configurar, siga as instruções e configure-o de forma correta e com dados válidos.

Para gerar o certificado.crt e chave.key de seu PFX e o certificado a importar em ambiente do banco do brasil acesse https://loja5.zendesk.com/hc/pt-br/articles/26402472522893-Como-Gerar-e-Configurar-os-Certificados-para-Integra%C3%A7%C3%A3o-Boleto-ou-Pix-no-Banco-do-Brasil e siga as instruções!

Configuração Geral:

Dados de Integração Banco do Brasil (recomenda-se configurar sempre em produção):

E por fim a aba de status de pedidos em sua loja.

6 - Pronto, após devidamente configurado realize teste de pagamento (nunca teste usando dados iguais ou do vendedor ou que tenha alguma informação igual), caso venha ter algum problema de integração, ative o modo Debug na configuração do módulo, finalize novos pedidos de teste e acesse o menu Pedidos ou Vendas > Banco do Brasil Pix > Logs, neste local vai ser salvos detalhes de erros ou problemas de integração quando as ocorrer em sua loja relacionado ao método de pagamento em questão.

Atenção: Não esquecer de antes ter configurado o Pix em sua conta Banco do Brasil (ter uma chave pix ativada e válida) e configurar seu aplicativo em https://app.developers.bb.com.br/login, e certificados ( https://loja5.zendesk.com/hc/pt-br/articles/26402472522893-Como-Gerar-e-Configurar-os-Certificados-para-Integra%C3%A7%C3%A3o-Boleto-ou-Pix-no-Banco-do-Brasil ), caso contrario não vai funcionar.

Configurado o Retorno Automático de Dados (webhook)

Para configurar o retorno de dados (atualização automática de status de pedido) acesse https://developers.bb.com.br/home selecione o aplicativo qual vai seu usado em integração e depois localize o webhook, crie um evento novo e cadastre sua url de webhook ( https://apoio.developers.bb.com.br/referency/post/672cf2b350e4e500133b947c ).

Configurado o cron de processamento em sua hospedagem?

Para configurar o cron de processamento em sua hospedagem acesse https://loja5.zendesk.com/hc/pt-br/articles/360018241291-Criando-uma-Cronjob-Tarefas-Cron- e siga as instruções do guia, o comando cron vai ser exibido na configuração do módulo em sua loja, o configure para rodar a cada 30 minutos.

Visualizando pedidos Recebidos

Para consultas o pedidos Banco do Brasil Hibrido feitos em sua loja, links de segunda via e detalhes da transação é bem simples, acesse o Menu Pedidos ou Vendas > Banco do Brasil Pix > Pedidos que vai exibir todos os pedidos feitos em sua loja por o método em questão, por este acesso poderá consultar por detalhes e status de pedidos.

Visualizando Logs e Erros
Para visualizar logs ative o modo debug da configuração do módulo Banco do Brasil, com isso todas transações são salvas no menu Pedidos ou Vendas >Banco do Brasil Pix > Logs.

Problema ao ativar um módulo?
https://loja5.zendesk.com/hc/pt-br/articles/360001980232-Problema-ou-erro-ao-ativar-um-m%C3%B3dulo-

Trocar o dominio da licença?
https://loja5.zendesk.com/hc/pt-br/articles/360002245071-Trocando-de-dom%C3%ADnio-em-um-m%C3%B3dulo-licenciado

Gostou de nosso módulo? Acesse nossa loja https://www.loja5.com.br e avalie o mesmo :)