O Pix ou boleto foi pago, mas o pedido não muda de status. O que fazer?

Quase sempre, o aviso de pagamento do PagBank está sendo bloqueado antes de chegar à sua loja, por firewall da hospedagem, ModSecurity ou Cloudflare.

1. Abra o pedido no painel do PagBank e veja, no fim da página, as notificações enviadas e a resposta de cada uma.
2. Em WooCommerce > Status > Logs, procure os arquivos de origem pagbank_webhook. Se não houver registros na data do pagamento, a notificação não chegou ao plugin.
3. Peça à hospedagem para liberar o endereço abaixo, com o método POST:

/wc-api/pagbank_woocommerce_handler

Na Cloudflare, confira as regras de WAF e os recursos de proteção contra bots.

Uso o Bot Fight Mode da Cloudflare. Como receber os webhooks?

O Bot Fight Mode gratuito não permite exceções por caminho. As alternativas são desativá-lo, usar um plano que permita criar uma regra para o caminho /wc-api/pagbank_woocommerce_handler, ou definir a constante PAGBANK_WEBHOOK_SITE_URL para usar um endereço próprio de recebimento, o que exige configuração avançada de servidor.

A hospedagem pediu os IPs do PagBank. Quais são?

O PagBank não usa uma lista fixa de IPs para webhooks. Peça a liberação por caminho, /wc-api/pagbank_woocommerce_handler, para qualquer IP.

Os meios de pagamento não aparecem no checkout.

O plugin aceita o checkout clássico e o Checkout Blocks. Confirme que está atualizado, que a conta está conectada e que o método está ativo em WooCommerce > Configurações > Pagamentos. Se continuar, abra um chamado informando qual checkout você usa.

O site apresentou um erro crítico depois de atualizar.

Se o painel não abrir, renomeie a pasta wp-content/plugins/pagbank-for-woocommerce por FTP para desativar o plugin. Depois abra um chamado com a mensagem de erro e as versões de PHP, WordPress, WooCommerce e do plugin.

O pagamento foi recusado. O problema é o plugin?

A recusa costuma vir do banco emissor ou da análise antifraude. Se o log mostrar um código de resposta do PagBank, envie-o no chamado. Dúvidas sobre motivos de recusa na sua conta são tratadas com o suporte do PagBank.

O checkout mostra "O cartão criptografado não foi identificado". Por quê?

Normalmente, um script do pagamento não carregou como deveria. Limpe os caches, desative temporariamente a otimização de JavaScript nas páginas de checkout e confirme que o plugin está atualizado. Se continuar, abra um chamado com os logs.

Apareceu "O cartão não pode ser autenticado" com 3DS ativo.

A autenticação 3D Secure foi recusada ou não pôde ser concluída. O cliente pode tentar outro cartão ou método. Se acontece com vários clientes, abra um chamado com os logs e a informação de quais cartões falham.

As parcelas não aparecem no checkout.

As parcelas são calculadas depois que o cliente digita o número do cartão, então esse é o comportamento esperado antes disso. Se o erro aparecer após digitar, verifique se o tema ou algum plugin de cache alterou os arquivos do plugin.

Não consigo conectar a conta, ou ela parece desconectada depois de conectar.

Tente em outro navegador, sem extensões. Se você usa cache, confira se a REST API do WordPress está sendo cacheada, pois isso já causou esse sintoma com LiteSpeed Cache. Exclua /wp-json/ do cache e tente de novo.

O QR Code do Pix é inválido.

Sua conta PagBank precisa ter uma chave Pix cadastrada. Depois de cadastrar, faça um novo pedido de teste. Se continuar inválido, conecte a conta novamente nas configurações do plugin e faça outro pedido.

O site apresentou um erro crítico depois de atualizar.

Se o painel não abrir, renomeie a pasta wp-content/plugins/pagbank-for-woocommerce por FTP para desativar o plugin. Depois abra um chamado com a mensagem de erro e as versões de PHP, WordPress, WooCommerce e do plugin.

O reembolso falhou ou o status não bateu.

Confira no painel do PagBank se o reembolso já existe, para não reembolsar duas vezes. Em caso de erro, abra um chamado com o número do pedido e a mensagem exibida.

Os campos aparecem duplicados no checkout.

Isso ocorre com plugins que também adicionam campos brasileiros, como Brazilian Market on WooCommerce ou o da LinkNacional. Informe no chamado qual plugin você usa e a versão.

Vocês atendem problemas da minha conta PagBank?

Este canal cobre a integração com o WooCommerce. Questões sobre conta, saldo e contestações devem ir ao suporte do PagBank.

Que dados devo enviar?

Use apenas o que o formulário pede. Nunca envie senhas, dados completos de cartão ou chaves de API. Antes de alguém ler um log, um processo automático mascara os dados pessoais e segredos que reconhece, e o arquivo original é apagado logo depois, ou em até 7 dias, sem que ninguém o leia, se a análise falhar. O log mascarado fica guardado por 90 dias. A máscara não é perfeita e, no que fica guardado, vale só para arquivos, então não cole um log no texto do chamado. Um log pode ter dados dos clientes da sua loja: revise o arquivo antes de enviar, se puder.