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:
- Boleto e/ou 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 (boleto + 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 Hibrido > 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 Hibrido > 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 Hibrido > 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 :)
Comentários
0 comentário
Artigo fechado para comentários.