# PagBank no WooCommerce: Configurar em 5 passos 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.

PagBank no WooCommerce: pré-requisitos antes do checkout
Pré-requisito	Valor mínimo	Impacto se faltar
Conta PagBank	Verificada e ativa	Token não é gerado
Certificado SSL	HTTPS válido	API recusa conexão
Versão do PHP	8.0 ou superior	Plugin não ativa
WooCommerce	8.x ou superior	Incompatibilidade de checkout

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.

PagBank no WooCommerce: métodos de pagamento comparados
Método	Tempo de aprovação	Melhor cenário
Pix	Segundos	Conversão rápida e tarifa baixa
Cartão de crédito	Imediato	Ticket alto com parcelamento
Boleto	Até 3 dias úteis	Cliente sem cartão

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

É possível aceitar Pix no WooCommerce com o PagBank sem maquininha?

Sim, sem maquininha. O Pix no WooCommerce com o PagBank depende só do plugin oficial e do token de produção, não de hardware. O PagBank gera o QR Code e confirma a compensação via webhook em segundos. A maquininha física do PagBank serve para venda presencial; na loja online, o arranjo de pagamento roda inteiro pela API, e o cliente paga direto no checkout sem nenhum equipamento.

Por que meu pedido fica preso em "aguardando pagamento" no PagBank?

Porque a notificação (webhook) não chegou ao WooCommerce. O PagBank aprova a cobrança e envia um aviso à URL /wc-api/ da loja, mas um firewall ou o cache de página bloqueia esse endpoint. Libere o user-agent do PagBank no WAF e exclua /wc-api/ do cache; o pedido passa a atualizar sozinho para "processando" em poucos segundos, sem você mexer manualmente em cada venda.

Qual a diferença entre o token de sandbox e o de produção no PagBank?

O token de sandbox roda no ambiente de teste e simula pagamentos sem mover dinheiro real. O de produção autoriza cobranças de verdade na sua conta PagBank. Cada um vem com um par de credenciais próprio. Misturar os dois é a causa mais comum de pagamento que aparece como aprovado no WooCommerce, mas nunca cai na conta bancária da loja.

Quanto custa usar o PagBank no WooCommerce?

O plugin oficial do PagBank no WooCommerce é gratuito; o custo é a taxa por transação. O Pix costuma ter a menor tarifa, e o cartão parcelado, a maior, com o valor caindo conforme o prazo de recebimento que você escolhe. Não há mensalidade fixa, então o gasto aparece a cada venda. Calcule a taxa sobre a sua margem antes de definir quem paga os juros do parcelamento.

O que fazer quando o cartão é recusado sem motivo aparente no checkout?

Confira o certificado SSL primeiro. A API do PagBank recusa conexões sem HTTPS válido, e o cartão falha sem mensagem clara para o cliente. Em seguida, valide se o token é de produção e não de sandbox. Nos tickets que acompanhamos na FULL, SSL vencido e token trocado respondem pela maioria das recusas silenciosas do 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.