Integrar o PagBank ao WooCommerce exige o plugin oficial, o token de produção e SSL ativo antes da primeira venda. Segundo o Baymard Institute (2024), cerca de 70% dos carrinhos são abandonados antes do pagamento. Pix cai em segundos; cartão suporta parcelamento. Teste em sandbox antes de liberar a loja.

Configurar o PagBank no WooCommerce significa conectar o gateway do banco digital brasileiro à sua loja para aceitar Pix, cartão de crédito e boleto sem contratar uma adquirência separada. O processo passa por instalar o plugin oficial, gerar o token de produção no painel do PagBank e validar o checkout com um pagamento de teste. Antes disso, a loja precisa de um certificado SSL válido, porque a API do PagBank recusa conexões sem HTTPS. Este guia cobre os 5 passos, os métodos de pagamento e os erros que travam o pedido em “aguardando pagamento”. Se a loja ainda não está no ar, comece pelo conteúdo de WooCommerce da FULL.

Primeiros passos: O que você precisa antes de usar o PagBank

Antes de ativar o PagBank no WooCommerce, três pré-requisitos evitam a maioria dos chamados de suporte: conta verificada no PagBank, WooCommerce 8.x rodando em WordPress 6.x e SSL ativo. A loja precisa de PHP 8.0 ou superior, já que o plugin oficial cortou versões anteriores em 2024. Sem esses itens, o checkout até carrega, mas a transação falha ao conversar com a API do banco.

Trate a tabela como checklist: pular qualquer linha gera pedido preso ou cartão recusado, e o guia de como configurar o WooCommerce cobre a base.

Legenda: a verificação de SSL e da versão do PHP evita os erros de conexão mais comuns no primeiro pagamento.

Passo a passo: Configurar o PagBank no WooCommerce

O caminho completo do PagBank no WooCommerce leva cerca de 15 minutos e tem 5 etapas: instalar o plugin, gerar o token, colá-lo no WooCommerce, escolher os métodos de pagamento e rodar um teste. A ordem importa, e colar o token de produção antes de validar em sandbox é a causa número um de pagamentos que somem do painel.

Passo 1: Instale o plugin oficial do PagBank

Acesse Plugins > Adicionar novo no painel do WordPress e busque por “PagBank Conecta”, o plugin oficial mantido pela própria empresa. Instale, ative e confirme que a versão é a mais recente, atualizada em 2026. Evite gateways não oficiais: eles costumam ficar sem manutenção e quebram a cada atualização do WooCommerce. O plugin oficial adiciona um menu próprio dentro de WooCommerce > Configurações > Pagamentos.

Passo 2: Gere o token de produção no PagBank

No painel do PagBank, em Venda Online > Integrações, gere o token de produção e copie o e-mail da conta vinculada. Esse par de token mais e-mail é o que autentica a loja na API. Há uma versão de sandbox e uma de produção; para vender de verdade, use a de produção e guarde o token como uma senha, porque ele autoriza cobranças diretas na sua conta.

Passo 3: Conecte o token no WooCommerce

Em WooCommerce > Configurações > Pagamentos, abra o PagBank e cole o token e o e-mail nos campos correspondentes. O plugin valida a conexão na hora e mostra um aviso verde quando as credenciais são aceitas. Se aparecer erro de autenticação, confira se não misturou token de sandbox com produção, o engano mais frequente nos tickets da FULL sobre o PagBank.

Passo 4: Escolha os métodos de pagamento

Ative no PagBank os meios que a loja vai aceitar: Pix, cartão de crédito com parcelamento e boleto. O Pix é o de aprovação mais rápida, em geral em segundos. Defina o número máximo de parcelas e se você ou o cliente assume os juros. Cada método ativo vira uma opção no checkout do WooCommerce, e o cliente escolhe na finalização da compra.

Passo 5: Rode um pagamento de teste

Com o token de sandbox e o modo de teste ligado, finalize uma compra usando os cartões de teste do PagBank. Confirme que o pedido muda para “processando” e que a notificação chega ao WooCommerce. Só depois de um teste bem-sucedido troque para o token de produção e desligue o sandbox. Esse passo evita a venda fantasma, em que a loja aceita o pedido mas o dinheiro não cai.

Legenda: a validação verde do token confirma que o WooCommerce conversa com a API do PagBank.

Métodos de pagamento: Pix, cartão e boleto comparados

A escolha dos métodos de pagamento define a conversão da loja. No PagBank, o Pix tem aprovação em segundos e tarifa menor; o cartão eleva o ticket médio com parcelamento, mas cobra taxa maior; o boleto atende quem não tem cartão, com compensação em até 3 dias úteis. Os três juntos cobrem quase todo perfil de comprador brasileiro, e ativar mais de um reduz o motivo de desistência no checkout do WooCommerce.

Combinar Pix e cartão costuma equilibrar melhor a velocidade de aprovação e o ticket médio. A tabela resume o trade-off de cada método dentro do PagBank, e a escolha depende do público da loja.

O guia dos melhores plugins de gateway de pagamento WooCommerce mostra onde cada opção se encaixa. No Brasil, o PagBank compete por banco digital e maquininha integrados; o Mercado Pago compete por Pix e parcelamento sem conta de adquirência separada; o Stripe compete por cobertura internacional e API para desenvolvedores.

Custo, taxa e ROI: Quanto o PagBank consome da venda

O custo do PagBank no WooCommerce não é mensalidade, e sim taxa por transação que varia conforme o método e o prazo de recebimento. O Pix costuma ter a menor tarifa; o cartão parcelado, a maior, e o valor cai quando você antecipa o recebível. O plugin oficial é gratuito; o gasto real aparece a cada venda, então calcule a taxa sobre a sua margem antes de definir quem paga os juros. Para medir o efeito de cada método, acompanhe a taxa de conversão antes e depois de ativar o PagBank, porque o retorno vem de reduzir o abandono no checkout.

Reduza o abandono ligando recuperação de carrinho

Ativar mais métodos resolve metade do problema; a outra metade é trazer de volta quem abandonou. Uma estratégia de checkout transparente no WooCommerce faz o cliente concluir o pagamento no PagBank sem sair da loja, o que reduz a fricção. Com cerca de 70% de carrinhos abandonados em média no e-commerce, segundo o Baymard, ligar a recuperação de carrinho costuma pagar o próprio esforço em poucas semanas.

Apoio especializado para sua loja WooCommerce

Configurar o PagBank no WooCommerce, manter o SSL em dia, otimizar o schema de produto e ainda recuperar carrinho exige um conjunto de plugins premium. Comprar cada licença avulsa soma centenas de reais por ano, e é aí que a conta pesa para quem administra loja no WordPress.

O plano PRO da FULL reúne Rank Math PRO, temas prontos para WooCommerce e ferramentas de performance por R$849 ao ano. Como o plano cobre até 10 sites, o custo cai para cerca de R$85 por site. É o tipo de conta que a gente vê fechar a favor de quem administra mais de uma loja no suporte da FULL. Veja os detalhes em FULL.services/planos.

Erros comuns: Pedido preso e pagamento que some

O erro que mais aparece nos tickets da FULL com o PagBank é o pedido travado em “aguardando pagamento” mesmo com a cobrança aprovada. A causa quase sempre é a URL de notificação (webhook) do PagBank batendo num endpoint /wc-api/ bloqueado por firewall ou servido pelo cache de página. O aviso nunca chega ao WooCommerce e o pedido fica no limbo, sem atualizar sozinho.

A correção é excluir a rota /wc-api/ do cache e liberar o user-agent do PagBank no endpoint da REST API. Em lojas com cache de página agressivo, o webhook chega mas a resposta vem do cache antigo, e o pedido não muda de status. O segundo erro é o pagamento fantasma: a venda consta como paga, mas o dinheiro nunca cai. Isso ocorre quando o token de sandbox fica ativo em produção. Nos testes que acompanhamos, resolve na maioria dos casos ao trocar o token pela versão de produção e desligar o sandbox.

Decisão rápida: Qual configuração do PagBank escolher

• Se você vende para o público geral brasileiro → ative Pix e cartão juntos no PagBank para cobrir aprovação rápida e ticket alto.
• Se a loja tem ticket médio alto → priorize o cartão com parcelamento e defina quem assume os juros antes de publicar.
• Se parte do público não usa cartão → mantenha o boleto ativo, aceitando a compensação em até 3 dias úteis.
• Se o pedido fica preso em aguardando pagamento → evite culpar o gateway, libere o webhook no firewall e exclua /wc-api/ do cache.

Perguntas frequentes sobre o PagBank no WooCommerce

Próximos passos para sua loja vender mais

Com o PagBank no WooCommerce configurado e testado, a loja aceita Pix, cartão e boleto com aprovação confiável. O ganho real não está só em receber pagamento, e sim em reduzir o abandono de carrinho oferecendo o método que cada cliente prefere. A partir daqui, refine o fluxo: ative a recuperação de carrinho, otimize a velocidade da página com o guia de WooCommerce lento e estruture o schema de produto para aparecer nas respostas de IA. Para aprofundar cada etapa, o FULL Academy reúne os tutoriais, guias e reviews de WooCommerce em um só lugar.