A integração entre PagBank e WooCommerce envolve duas configurações: a extensão ativa na loja e a conta/credenciais do meio de pagamento. Os nomes, requisitos e métodos disponíveis podem mudar. Consulte a documentação do PagBank para a versão do plugin que pretende instalar e confirme que a loja está em HTTPS.
Prepare a loja e a conta
Atualize WordPress e WooCommerce dentro do processo de manutenção da loja; faça uma cópia recuperável antes de instalar uma extensão. Confira no diretório de plugins do WordPress quem mantém a extensão e se é a integração indicada pelo PagBank. Separe ambiente de teste de produção e não compartilhe tokens ou chaves em páginas públicas, email ou capturas de tela.
Configure e teste a jornada
Instale a extensão segundo as instruções oficiais vigentes, conecte a conta pelo mecanismo documentado e habilite somente os meios que a operação pode atender. Revise moeda, mensagens, retorno do checkout e atualização do pedido. Faça pedidos com credenciais e modos de teste apropriados; verifique a loja e o painel do provedor para comparar status e notificações. Nunca simule pagamento real com dados inventados.
Teste pelo menos aprovação, recusa, cancelamento e retorno após pagamento, quando esses estados forem suportados no ambiente. Confira também email, estoque, reembolso e consistência do pedido no painel. Só depois da validação, configure as credenciais de produção e faça uma transação controlada conforme as regras do provedor.
Quando investigar uma falha
Registre horário, identificador do pedido e mensagem sem expor dados do comprador. Confira logs do WooCommerce, versão da extensão, permissões da conta e eventuais bloqueios de firewall. Se a cobrança aparece no provedor mas o pedido não atualiza, investigue notificações/webhooks com o suporte oficial antes de repetir a cobrança.
Referências oficiais
- Documentação PagBank para WooCommerce
- Processo de integração do PagBank com WooCommerce
- Extensão PagBank no diretório oficial do WordPress
- Testar pedidos no WooCommerce