# PagSeguro no WooCommerce: Configurar em 5 passos
Integrar o PagSeguro 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 PagSeguro no WooCommerce significa conectar o gateway de pagamento brasileiro à sua loja para aceitar Pix, cartão de crédito e boleto sem precisar de uma conta de adquirência separada. O processo passa por instalar o plugin oficial, gerar o token de produção no painel do PagSeguro e validar o fluxo de checkout com um pagamento de teste. Antes de tudo isso, sua loja precisa de um certificado SSL válido, porque a API do PagSeguro recusa conexões sem HTTPS. Este guia cobre os 5 passos, os métodos de pagamento e os erros mais comuns que travam o pedido em "aguardando pagamento". Se você ainda não tem a loja no ar, comece pelo conteúdo de WooCommerce da FULL.
---
## Primeiros passos: O que você precisa antes de começar
Antes de ativar o PagSeguro no WooCommerce, três pré-requisitos evitam a maioria dos chamados de suporte: conta verificada no PagSeguro (UOL), WooCommerce 8.x rodando em WordPress 6.x e SSL ativo. A loja precisa de PHP 8.0 ou maior, já que o plugin oficial cortou versões anteriores em 2024. Sem esses itens, o checkout carrega mas a transação falha ao falar com a API.
Trate a tabela abaixo como checklist: pular qualquer linha gera pedido preso ou cartão recusado. Se a loja ainda não existe, o guia de como configurar o WooCommerce cobre a base antes de você mexer no gateway.
PagSeguro no WooCommerce: pré-requisitos antes do checkout
| Pré-requisito |
Valor mínimo |
Impacto se faltar |
| Conta PagSeguro | 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 versão do PHP evita os erros de conexão mais comuns no primeiro pagamento.
---
## Passo a passo: Configurar o PagSeguro no WooCommerce
O caminho completo do PagSeguro 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: colar o token de produção antes de validar em modo sandbox é a causa número um de pagamentos que somem do painel.
### Passo 1: Instale o plugin oficial do PagSeguro
Acesse Plugins > Adicionar novo no painel do WordPress e busque por "PagBank PagSeguro for WooCommerce", o plugin oficial mantido pela própria empresa. Instale, ative e confirme que a versão é a mais recente, atualizada em 2026. Evite plugins não oficiais de gateway: 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 painel do PagSeguro, em Venda Online > Integrações, gere o token de produção e copie o e-mail da conta vinculada. Esse par 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 na sua conta.
### Passo 3: Conecte o token no WooCommerce
Em WooCommerce > Configurações > Pagamentos, abra o PagSeguro e cole o token e o e-mail nos campos correspondentes. O plugin valida a conexão na hora e mostra um aviso verde se as credenciais forem 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 PagSeguro.
### Passo 4: Escolha os métodos de pagamento
Ative no PagSeguro no WooCommerce os meios que sua 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.
### 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 PagSeguro. 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 o cenário de 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 PagSeguro.
---
## Métodos de pagamento: Pix, cartão e boleto comparados
A escolha dos métodos de pagamento define a conversão da loja. No PagSeguro, 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.
Combinar Pix e cartão costuma equilibrar melhor velocidade de aprovação e ticket médio. A tabela abaixo resume o trade-off de cada método dentro do PagSeguro.
PagSeguro 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 PagSeguro compete por marca consolidada no varejo e maquininha física; o Mercado Pago compete por aceitar 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 PagSeguro consome da venda
O custo do PagSeguro 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.
O retorno vem de reduzir o abandono no checkout: cada método a mais que você aceita é um motivo a menos para o cliente desistir. Em lojas que rodam Pix junto com cartão, a maior parte das vendas migra para o Pix justamente pela aprovação imediata, o que melhora o fluxo de caixa. Para medir esse efeito, acompanhe a taxa de conversão antes e depois de ativar cada método de pagamento.
### Reduza o abandono ligando recuperação de carrinho
Ativar mais métodos resolve metade do problema; a outra metade é trazer de volta quem abandonou. Conecte uma estratégia de checkout transparente no WooCommerce para que o cliente conclua o PagSeguro sem sair da loja. Com cerca de 70% de carrinhos abandonados em média no e-commerce, segundo o Baymard, essa etapa costuma pagar o próprio esforço em poucas semanas.
---
## Apoio especializado para sua loja WooCommerce
Configurar o PagSeguro 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. 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 PagSeguro é o pedido travado em "aguardando pagamento" mesmo com a cobrança aprovada. A causa quase sempre é a URL de notificação (webhook) do PagSeguro batendo num endpoint 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 PagSeguro no endpoint da REST API. 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 modo sandbox.
---
## Decisão rápida: Qual configuração escolher
- Se você vende para o público geral brasileiro → ative Pix e cartão juntos no PagSeguro para cobrir aprovação rápida e ticket alto.
- Se a loja tem ticket médio alto → priorize 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 PagSeguro no WooCommerce
É possível aceitar Pix no WooCommerce sem usar um gateway externo?
Não sem um gateway. O Pix no WooCommerce depende de um intermediário, e o PagSeguro gera o QR Code e confirma a compensação via webhook. O WooCommerce nativo não fala com o Banco Central, então o plugin oficial do PagSeguro é o que conecta a loja ao arranjo de pagamento e libera o Pix em segundos no checkout, sem você operar a chave diretamente.
Por que meu pedido fica preso em "aguardando pagamento" no PagSeguro?
Porque a notificação (webhook) não chegou ao WooCommerce. O PagSeguro 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 PagSeguro no WAF e exclua /wc-api/ do cache; o pedido passa a atualizar sozinho para "processando" em poucos segundos.
Qual a diferença entre o token de sandbox e o de produção?
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 PagSeguro. 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 PagSeguro no WooCommerce?
O plugin oficial do PagSeguro 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 PagSeguro 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 PagSeguro no WooCommerce.
---
## Próximos passos para sua loja vender mais
Com o PagSeguro no WooCommerce configurado e testado, sua 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.