# Configurar pix no WooCommerce: Guia em 4 passos Configurar Pix no WooCommerce exige um gateway homologado, chave Pix válida e QR Code dinâmico antes de ir ao ar. Na prática, a gente vê no suporte da FULL que a maioria das falhas não é instalação, é o webhook bloqueado que deixa o pedido pago preso em "aguardando pagamento". O QR estático falha acima de 300 pedidos por dia. Faça um pedido-teste antes de divulgar. Configurar Pix no WooCommerce significa instalar um gateway de pagamento que gere cobrança Pix com QR Code e confirme o pedido por webhook. A loja precisa de um plugin homologado por uma instituição de pagamento, uma chave Pix ativa e o checkout pronto para exibir o botão. Sem o webhook, o pedido fica preso em "aguardando pagamento" mesmo após o cliente pagar. Este guia mostra o caminho completo, do gateway ao pedido-teste, e onde cada etapa costuma travar. Se você ainda não subiu a base da loja, comece pelos conteúdos de WooCommerce da FULL e volte aqui para o pagamento. --- ## Primeiros passos: Visão geral do pix no checkout Configurar Pix no WooCommerce envolve quatro decisões antes de mexer em qualquer botão: gateway, tipo de chave Pix, QR Code estático ou dinâmico e como o status muda sozinho. Nas lojas que chegam ao suporte da FULL, o erro mais comum não é a instalação, é o pedido pago que não baixa por falta de webhook.
Configurar Pix no WooCommerce: decisão, opção e impacto
Decisão Opção recomendada Impacto na loja
Gateway Mercado Pago, Efi ou PagBank Define tarifa por venda e antifraude
Tipo de QR Code Dinâmico com txid por pedido Permite baixa automática no painel
Confirmação Webhook ativo no servidor Muda o status sem conferência manual
Checkout Blocos do WooCommerce 9.x Exige gateway compatível com blocos
Cada linha vira um passo deste guia. A escolha do gateway pesa mais do que parece: define a tarifa e se o botão Pix renderiza no checkout em blocos. Para comparar opções, vale conferir os 15 melhores plugins de gateway de pagamento para WooCommerce. --- ## Passo a passo: Configurar pix no WooCommerce em 4 passos Configurar Pix no WooCommerce leva cerca de 30 minutos quando a conta na instituição de pagamento já está aprovada. O fluxo tem quatro etapas: instalar o gateway, conectar a credencial, definir a chave e o QR Code, e validar com um pedido real. Faça na ordem, porque pular a credencial deixa o botão sem gerar cobrança. ### Instale o gateway de pagamento pix Instale o plugin do gateway pelo menu Plugins > Adicionar novo, buscando pelo nome da instituição (Mercado Pago, Efi ou PagBank). Cada um publica uma extensão oficial para WooCommerce, o que evita gateways genéricos que quebram a cada atualização. Após ativar, o gateway aparece em WooCommerce > Configurações > Pagamentos, conforme a documentação oficial do WooCommerce. Mantenha o WooCommerce 9.x e o PHP 8.2 atualizados: gateways antigos baseados em shortcode tendem a não renderizar no checkout em blocos. ### Conecte a credencial da instituição Conecte a loja à sua conta de pagamento colando as credenciais de API (Access Token ou Client ID/Secret) no painel do gateway. Esse é o ponto que mais gera ticket: sem a credencial válida, o Pix aparece no checkout mas nunca emite a cobrança. Gere o token no painel da instituição, cole no campo correspondente e salve. Ative o modo sandbox primeiro para testar sem mover dinheiro real. Um certificado SSL válido é obrigatório: instituições de pagamento recusam conexão sem HTTPS ativo no domínio. ### Defina a chave pix e o QR code dinâmico Configure a chave Pix recebedora e escolha o QR Code dinâmico no painel do gateway. O QR dinâmico gera um txid único por pedido, e isso é o que permite a baixa automática: o webhook identifica qual pedido foi pago e muda o status sozinho. O QR estático usa o mesmo código para todos, o que vira gargalo de conciliação acima de 300 pedidos por dia. Defina também o tempo de expiração da cobrança (15 a 60 minutos é o intervalo seguro) para evitar pagamentos fora do prazo que precisam de estorno manual. ### Valide com um pedido-teste real O último passo para configurar Pix no WooCommerce é testar: faça um pedido-teste de valor baixo, pague o Pix e confirme que o status muda para "processando" sem intervenção. Esse teste expõe o problema silencioso mais comum: o pedido pago que fica em "aguardando pagamento" porque o servidor bloqueia a requisição de retorno (webhook) da instituição. Se o status não mudar em até dois minutos, libere o endpoint de webhook no firewall do servidor. Só divulgue o Pix depois que um pagamento real tiver baixado corretamente no painel de pedidos. --- ## Compatibilidade: Pix no checkout em blocos do WooCommerce 9.x Configurar Pix no WooCommerce 9.x exige gateway compatível com a API de blocos do checkout, e nem todo plugin Pix entrega isso. Checkout em blocos somado a gateway antigo de shortcode resulta em botão Pix que não renderiza na finalização, sem erro visível. Nos chamados que a gente vê no suporte da FULL, esse é um sintoma recorrente após a migração do checkout clássico. Quando o botão some, a saída rápida é voltar ao shortcode `[woocommerce_checkout]` enquanto o gateway não atualiza, ou trocar por uma extensão que já suporta blocos. Mercado Pago, Efi e PagBank publicam versões compatíveis, mas a defasagem entre lançamento do WooCommerce e atualização do plugin costuma ficar entre uma e três semanas. Para personalizar a tela sem quebrar o gateway, veja como personalizar o checkout do WooCommerce no Elementor com plugins que respeitam a API de pagamento. --- ## Custo por venda: Tarifas de pix em cada gateway Ao configurar Pix no WooCommerce, a tarifa fica em geral entre 0,99% e 1,99% por transação, bem abaixo dos 3,99% a 4,99% típicos de cartão de crédito. Efi (Gerencianet) opera Pix nativo com tarifa baixa; Mercado Pago cobra mais, mas embute antifraude; PagBank prioriza liquidação rápida. O Pix também não tem antecipação: o dinheiro cai na conta em segundos, o que muda o fluxo de caixa de quem vende ticket alto. Esse custo entra na conta de qualquer loja ao configurar Pix no WooCommerce com volume real. Para comparar gateways além do Pix, o material sobre usar vários gateways de pagamento no WooCommerce ajuda a montar a combinação certa. E vale lembrar: oferecer Pix não substitui ter um fluxo de cobrança redundante, como mostra o guia de como coletar pagamentos usando o WordPress. A maioria das lojas que confia em um único método perde venda quando ele cai. --- ## Segurança e conciliação: O webhook é o ponto crítico do pix Configurar Pix no WooCommerce resolve o pagamento, mas a operação só roda sozinha quando o retorno da instituição (webhook) chega ao servidor sem ser bloqueado. Esse endpoint precisa estar acessível por HTTPS e liberado no firewall, porque é ele que muda o status do pedido de "aguardando pagamento" para "processando" assim que o Pix cai. Quando o webhook falha em silêncio, o pedido pago não baixa e a loja perde a confiança no automático. Na prática, vemos no suporte da FULL que a conciliação manual é o que mais consome tempo do lojista quando o QR é estático: sem txid por pedido, o sistema não identifica qual cobrança foi paga. Proteja o endpoint de webhook com validação de assinatura (HMAC), use sempre HTTPS no domínio e mantenha o gateway homologado e atualizado, conforme a documentação oficial do WooCommerce. A baixa automática confiável depende muito mais dessa camada de retorno do que da marca do gateway escolhido. --- ## Ferramentas e gateways recomendados para pix Para configurar Pix no WooCommerce, quatro gateways dominam o mercado no Brasil, e a escolha depende de tarifa, antifraude e velocidade de liquidação. Mercado Pago traz antifraude embutido; Efi (Gerencianet) foca em Pix nativo com tarifa enxuta; PagBank prioriza recebimento rápido; e o Asaas atende cobrança recorrente. Cada um publica extensão oficial homologada, o que reduz risco de quebra a cada atualização do WooCommerce 9.x. Ao configurar Pix no WooCommerce, a decisão técnica importa mais do que a marca. Mercado Pago compete por aprovação e antifraude; Efi compete por Pix nativo e tarifa baixa; PagBank compete por liquidação rápida e presença de maquininha. Avalie o volume da loja, o ticket médio e se você precisa de split de pagamento antes de fechar. Para a base completa da loja, o passo anterior é configurar o WooCommerce corretamente antes de plugar qualquer gateway de pagamento. --- ## Quando o pix no WooCommerce trava: Árvore de decisão Ao configurar Pix no WooCommerce, o pagamento costuma travar em quatro pontos previsíveis, e cada sintoma tem uma causa técnica direta. Pedido pago que não baixa quase sempre é webhook bloqueado; botão que não aparece é incompatibilidade com o checkout em blocos. A árvore abaixo encaminha o diagnóstico em nós auto-contidos. Cada nó resolve um ticket recorrente sem abrir o código do gateway. Quando o problema persiste, a causa costuma estar no servidor, em bloqueio de saída. --- --- ## Receba por pix com o ambiente certo no plano da FULL Configurar Pix no WooCommerce funciona melhor quando a loja roda com plugins premium licenciados e suporte que entende de checkout. No plano Pro da FULL, por R$849,90 por mês para até 10 sites, você divide o custo em cerca de R$85 por site e ainda recebe Rank Math PRO, WP Rocket e os demais plugins premium inclusos, sem licença avulsa. A gente vê no suporte da FULL que a maioria das quebras de Pix nasce de ambiente desatualizado, e não do gateway, e que configurar Pix no WooCommerce flui quando a base está em dia. Conheça os planos da FULL e suba sua loja com a base certa. --- ---

Perguntas frequentes sobre pix no WooCommerce

Por que o pedido pago via Pix fica como aguardando pagamento no WooCommerce?

O webhook da instituição de pagamento está bloqueado pelo servidor. O Pix é pago, mas o retorno que avisa o WooCommerce não chega, então o status não muda. Libere o endpoint de webhook no firewall e confirme que o gateway usa QR Code dinâmico com txid por pedido. Sem o txid, mesmo com o webhook liberado, o sistema não sabe qual pedido baixar.

É possível configurar Pix no WooCommerce sem CNPJ?

Sim, é possível configurar Pix no WooCommerce sem CNPJ, usando CPF em gateways como Mercado Pago e PagBank, que aceitam conta de pessoa física. A diferença está nas tarifas e nos limites de recebimento, geralmente menores na conta CPF. Para volume alto ou venda recorrente, o CNPJ libera tarifas melhores e split de pagamento. Confirme o limite mensal da sua conta antes de divulgar o Pix como meio principal.

Qual a diferença entre QR Code Pix estático e dinâmico no checkout?

O QR dinâmico gera um código único por pedido, com txid, e permite baixa automática via webhook. O estático usa o mesmo código para todos os pagamentos, sem identificar o pedido, o que exige conciliação manual. Acima de 300 pedidos por dia, o estático vira gargalo. Para qualquer loja que processe volume, o dinâmico é o único que sustenta a automação do status do pedido.

Quanto custa receber por Pix no WooCommerce em cada gateway?

A tarifa de Pix fica em geral entre 0,99% e 1,99% por transação, contra 3,99% a 4,99% do cartão de crédito. Efi (Gerencianet) costuma ter a tarifa mais baixa por operar Pix nativo; Mercado Pago cobra um pouco mais com antifraude embutido; PagBank prioriza liquidação rápida. O Pix não tem antecipação porque o valor cai na conta em segundos. Confirme a tarifa vigente no contrato, já que cada gateway revisa os percentuais periodicamente.

O que é necessário para o Pix aparecer no checkout em blocos do WooCommerce?

O gateway precisa declarar suporte à API de blocos do WooCommerce 9.x. Plugins antigos baseados em shortcode não renderizam o botão Pix no checkout em blocos, e o erro acontece sem aviso visível. Atualize a extensão para a versão compatível com blocos, ou volte temporariamente ao shortcode clássico do checkout. Mercado Pago, Efi e PagBank já publicam versões que suportam blocos, com defasagem de uma a três semanas após cada release.

--- ## Próximos passos para vender por pix com segurança Configurar Pix no WooCommerce é uma sequência previsível em quatro passos: gateway oficial, credencial válida, QR dinâmico com webhook e pedido-teste real antes de divulgar. O ponto que mais trava não é a instalação, é a baixa automática do pedido, que depende do webhook liberado e do txid por pedido. Resolva isso primeiro e o resto flui. Antes de escalar, garanta que a base da loja esteja firme com o passo a passo de criar uma loja virtual no WordPress com WooCommerce. Para aprofundar cada etapa da operação, o guia de como criar uma loja online com WordPress reúne os tutoriais em sequência. Para continuar aprendendo, o FULL Academy organiza tutoriais, guias e reviews de WordPress em um só lugar.

Legenda: a tela de Pagamentos do WooCommerce é onde o gateway Pix é ativado e conectado à credencial.