Como integrar o Pix em sua loja OpenCart 3
A Woovi disponibiliza uma extensão para o OpenCart 3 que permite a integração do Pix em seu checkout, com suporte à atualização automática do status de seus pedidos e logs.
A plataforma efetua em tempo real a conciliação entre seu Banco e sua loja. Após conectar a sua conta na Woovi é possível cobrar clientes em tempo real com QrCodes Pix, enviar links de pagamento e gerenciar cobranças incluindo extornos.
Veja como é fácil aumentar suas vendas integrando o Pix em sua loja:
Pré-requisitos
- Uma loja com o OpenCart 3 instalado.
Instalação
Antes de instalar a extensão, é importante garantir que ela esteja disponível na sua loja. Isso pode ser feito de duas maneiras: através do marketplace ou fazendo o upload do arquivo da extensão.
Marketplace
A maneira mais conveniente de baixar a extensão em sua loja é acessando o marketplace oficial do OpenCart. Lá, você encontrará a extensão pronta para ser baixada e instalada com facilidade.
Veja como você pode baixar utilizando o marketplace:
1) Acesse o painel de administração
Para acessar o marketplace e carregar a extensão na sua loja, siga estes passos simples:
No painel de administração da sua loja, localize a barra lateral e clique na opção Extensions.
Em seguida, no submenu que é exibido, clique na opção Marketplace:
Ao seguir essas etapas, você será direcionado para o marketplace oficial do OpenCart.
2) Pesquise a extensão
Ao acessar o marketplace, pesquise pela extensão woovi:
3) Carregue a extensão
Desça um pouco a página até localizar a seção de Download e identifique a versão mais recente da extensão em Available installs. Ao lado desta versão, haverá um botão marcado como Install. Clique nesse botão para carregar a extensão.
Upload do arquivo
Além do marketplace, você também tem a opção de carregar manualmente o arquivo da extensão. Para isso, acesse a página de downloads no marketplace oficial e baixe primeiramente o arquivo mais recente da extensão compatível com OpenCart 3:
Assegure-se de que o nome do arquivo da extensão seja woovi.ocmod.zip ao fazer o upload, porque o OpenCart considera o nome do arquivo como um "identificador" da extensão, que precisa ser woovi.
Após isso, acesse a página do instalador de extensões, localizado na opção Installer no menu Extensions do OpenCart:
Ao acessar a página do instalador de extensões, localize o botão de Upload azul:
Clique nesse botão e selecione o arquivo da extensão que deseja carregar.
Instalando o método de pagamento Woovi Pix
Até o momento, você conseguiu instalar os arquivos da extensão do seu site. Agora, é necessário instalar o método de pagamento Woovi Pix em sua loja.
Para fazer isso, acesse a página de extensões através da sub-opção Extensions dentro da opção Extensions localizada na barra lateral do painel de administração:
Na página de extensões, utilize a opção de filtro para selecionar extensões do tipo Payment:
Role um pouco para baixo na página e clique no botão verde com o símbolo "+" na extensão Woovi Pix para que o método de pagamento seja instalado com sucesso:
Após isso, clique no botão azul com o ícone de um lápis para acessar a página de configuração da extensão.
Instalando o método de pagamento Woovi Parcelado
Para instalar o método de pagamento Woovi Parcelado, siga os mesmos passos utilizados na instalação do Woovi Pix, porém aplicados ao Woovi Parcelado:
Configuração
Após acessar a página de configurações da extensão, é necessário ativar a extensão no checkout pressionando o botão Status:
Tendo habilitado o botão Status, Pix deverá aparecer como método de pagamento no checkout.
No entanto, é necessário integrar a extensão com a plataforma Woovi e isto pode ser feito adicionando a url de webhook na plataforma.
Para obter essa URL, vá até a página de configurações e copie ela:
Entre na plataforma da Woovi e clique aqui ou vá em API/Plugins > OpenCart > Adicionar:
Cole a URL de webhook no campo Preencha a url do seu site e pressione o botão Salvar:
Após isto, verifique se o AppID, um código que identifica sua loja, se encontra na página de configurações:
Pronto, agora vamos aprender como utilizar o Pix no seu checkout.
Como utilizar o Pix no checkout
Ao realizar uma compra em sua loja OpenCart, o cliente será redirecionado para a página de checkout.
Nesta página, o cliente deverá inserir seu CPF ou CNPJ, que será utilizado para a cobrança Pix:
Após isso, o cliente deve selecionar Pix como método de pagamento (Payment Method):
Ao confirmar a compra, o QR Code do Pix será exibido na página de sucesso, pronto para ser escaneado pelo seu cliente:
CPF/CNPJ
O CPF/CNPJ utilizado nas cobranças do Pix pode ser obtido de duas formas:
- Através dos custom fields (campos personalizados) do OpenCart.
- Ou diretamente durante o checkout.
Os custom fields são uma funcionalidade do OpenCart que permitem adicionar campos adicionais nos dados dos clientes.
Durante a instalação, a extensão configura automaticamente o custom field necessário para que os clientes possam inserir seu CPF/CNPJ durante o registro:
Caso deseje, é possível alterar o custom field utilizado ou até mesmo desativar essa configuração no painel de administração, selecionando a opção None (Nenhum):
Se a extensão não puder encontrar um custom field, no checkout irá aparecer diretamente um campo para que o cliente possa inserir seu CPF ou CNPJ, logo acima do botão de confirmação do pedido:
Como configurar os status dos pedidos
As configurações dos status de cada pedido podem ser encontradas na página de configurações:
Quando um pedido for criado
Por padrão, quando a cobrança da Woovi é criada, o status do pedido é alterado para Pending (pendente). No entanto, é possível configurá-lo para qualquer status desejado:
Veja um exemplo de pedido que acabou de ser criado:
Quando o pedido for pago
Por padrão, quando a cobrança da Woovi é paga, o status do pedido é alterado para Processing (processando). No entanto, é possível configurá-lo para qualquer status desejado:
Veja um exemplo de pedido que acabou de ser pago:
Como configurar o título do método de pagamento Pix
Para modificar o título a ser empregado para o método de pagamento via Pix durante o processo de checkout, dirija-se à página de configurações da extensão.
Configure o título do método de pagamento no campo Payment method title (Título do Método de Pagamento):
Observe o novo título do método de pagamento durante o processo de checkout.
Como visualizar os logs da sua loja
Você pode acessar os logs da sua loja acessando a página localizada na barra lateral do seu painel de administração, em System (Sistema) > Maintenance (Manutenção) > Error logs (Registro de erros):
Nessa página de logs, deve aparecer os erros registrados da sua loja:
