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.

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.

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

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.