Como Instalar o Plugin API Pix Banco do Brasil para Woocommerce?

Atenção:
1- Para obter o plugin, baixar ou obter atualizações acesse sua conta > downloads em www.loja5.com.br
2- Para atualizações de módulos e plugins o processo é o mesmo de instalação (guia abaixo), lembre-se de fazer backup antes e após atualizar os arquivos reconfigurar todo seu módulo novamente.

Atenção a Usuários da Versão 1.0:
Caso esteja usando está versão já em produção não é recomendado atualizar para versão 2.0, isso porque nesta versão está para nova API do BB que é a v2, caso atualize será preciso refazer tudo seu processo de homologação e configuração junto ao Banco do Brasil.

Instalando e configurado o plugin Banco do Brasil API Pix em seu Woocommerce

Requisitos:
- Woocommerce >= 3.x / 4.x / 5.x / 6.x / 7.x
- Ter conta Banco do Brasil PJ (empresa)
- Criar uma conta em https://developers.bb.com.br/home para obter os dados de integração.
- Integração de Sandbox acesse (toda integração inicial deverá ser em sandbox) https://apoio.developers.bb.com.br/sandbox/spec/post/5fe9e7f13b02bd0012eca9f1 
- Integração em Produção acesse (depois de integrado em sandbox e testado solicite a produção) https://apoio.developers.bb.com.br/referency/post/6050dda3737e1c0012e2d00e 
- Ter certificado PFX (e.CNPJ) vai ter usado para configurar o mTLS no Banco do Brasil

Atenção: Ao simular um pedido em ambiente de sandbox o mesmo é restrito a alguns dados de teste, no caso usar o CPF 28779295827 como cliente.

Método de Pagamento Suportado:
- Pix direto em conta Banco do Brasil

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 (user winrar) o arquivo baixado em nossa loja.


2 - A instalação poderá ser feita por FTP ou diretamente no admin de seu Wordpress, para instalação por FTP primeiramente acesse o servidor de sua loja via FTP, ao acessar acesse o diretório "wp-contents/plugins" e envie a pasta de seu módulo "loja5-woo-bb-pix" para  dentro do diretório de plugins de seu wordpress e aguarde a conclusão do Upload dos arquivos, para instalação via painel administrativo acesse o admin de seu wordpress depois Plugins > Adicionar Novo, na barra vai ter o botão "Enviar Plugin", clique e selecione o arquivo zipado de seu plugin "loja5-woo-bb-pix.zip" (o zipe antes .ZIP), clique em instalar e aguarde o procedimento.

3 - Depois de instalado por um dos métodos acima verifique se seu plugin já esta instalado e ativo, acesse o menu Plugins > Plugins instalados e veja se o mesmo vai exibir na lista e se já esta ativado, caso não exiba verifique se fez os passos anteriores corretamente e caso exiba e não esteja ativo clique em ativar.

4 - Após ativado acesse o menu Wocommerce > Configurações na aba Pagamentos vai lista os métodos de pagamento do plugin instalado, clique nos métodos qual deseja usar em sua loja para exibir a tela de configuração, no caso 'API Pix Banco do Brasil' inicialmente deverá ativar a licença do plugin em sua loja, 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.

5 - Depois de instalado e ativado o plugin com o seu serial de registro, siga as instruções de cada campo e informe todos os dados solicitados (integração, regras de negocio, status, etc), em cada campo vai ter uma breve descrição do dado solicitado, informe todos os dados corretamente.

Informe todos os dados exatamente como é solicitado e realize um teste de compra em sua loja e veja o resultado.

Atenção:
- Ambiente sandbox as vendas não tem valor real!
- Jamais configure o status 'Aguardando Pagamento' com o status 'Pagamento Pendente' do Woo, caso faça isso poderá ocorrer problemas de cancelamento por tempo de estoque e o cliente não receberá e-mail com dados do pedido.

1 - Configurando o meu Certificado Digital no Banco do Brasil (Produção mTLS)?

1 - Instale o GitBash em seu PC https://git-scm.com/downloads 
2 - Acesse https://apoio.developers.bb.com.br/referency/post/5f80a25fd9493f0012973463 e siga as instruções.

2 - Configurando e Criando o certificado.crt e chave.key para uso na loja (Produção mTLS)?

1 - Instale o GitBash em seu PC (caso não tenha ainda instalado) https://git-scm.com/downloads 
2 - Renomei-e o seu certificado PFX para certificado.pfx
3 - Abra o console do GitBash (no mesmo local ou diretorio onde se encontra o arquivo certificado.pfx em seu PC), com o lado direito do mouse clique em Open Git Bash hehe

4 - Com a tela do Git Bash aberto digite as linhas abaixo, uma por vez até existir ter novos arquivos (em algumas das etapas vai pedir a senha, no caso informe a senha de seu certificado PFX).
a - openssl pkcs12 -in certificado.pfx -nocerts -out chave-cripto.key
b - openssl pkcs12 -in certificado.pfx -clcerts -nokeys -out certificado.crt
c - openssl rsa -in chave-cripto.key -out chave.key

No processo acima vai ser criado 3 arquivo (se feito com sucesso), mas deste apenas 2 será usando na loja que vai ter o arquivo certificado.crt e o chave.key que deverá ser feito o envio/upload via FTP para dentro do diretório principal do plugin em sua loja (wp-content/plugins/loja5-woo-bb-pix), ao ser enviado veja se na config do plugin vai exibir como abaixo, se sim está tudo ok.

Problemas de Integração ou Erros?
Caso tenha algum problema de integração ou erro ative o modo debug, ao ativar o mesmo vai salvar todos os envios e retorno a api do BB, realize um teste e visualize os logs em Woocommerce >  Status > Logs em seu woocommerce  e escolhe o log referente ao plugin em questão.

Consultado Pix Emitidos na Loja

Para consultar todos os pix emitidos em sua loja no menu principal do admin de seu wordpress clique no menu abaixo para ter acesso aos pedidos.

Ao acessar será exibido a lista com todos os pedidos Pix Banco do Brasil e detalhes do mesmo.

Cron e Webhook

Para baixa automática de pedidos e atualização dos status em sua loja configure os crons para executar a cada meia hora e a url de webhook em seu painel banco do brasil developers (https://developers.bb.com.br/home), ambas urls exibidas na config de seu plugin.

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 :)