PIX no WooCommerce: Como Configurar Mercado Pago e PagSeguro

Quem trabalha com e-commerce no Brasil sabe: oferecer PIX deixou de ser diferencial e virou pré-requisito. A taxa de abandono de carrinho cai de forma visível quando o cliente tem essa opção no checkout. O problema é que configurar PIX no WooCommerce não é questão de instalar um plugin e apertar um botão. Há detalhes que separam uma integração que funciona de uma que gera suporte toda semana.

Já auditamos mais de 200 instalações WooCommerce no Brasil. O erro de configuração de gateway de pagamento é, de longe, o mais recorrente. Este post cobre como fazer isso direito usando Mercado Pago e PagSeguro, os dois gateways mais adotados por lojas brasileiras.

Por que PIX virou prioridade em lojas WooCommerce

Os dados são claros. Em 2023, o PIX ultrapassou o cartão de crédito em volume de transações no Brasil. Para lojas virtuais, isso se traduz em custo menor e conversão maior. O cartão de crédito cobra entre 2% e 5% por transação. O PIX no WooCommerce via Mercado Pago ou PagSeguro sai entre 0% e 1,99%, dependendo do plano contratado.

A liquidez também conta. O dinheiro cai na conta em segundos, o que muda o fluxo de caixa de lojas menores de forma concreta. Não é dado aleatório: lojas que ativam PIX relatam aumento de 15% a 30% nas vendas finalizadas. Esse número vem direto de clientes que acompanhamos ao longo do processo de implantação.

Configurando PIX com Mercado Pago no WooCommerce

O plugin oficial é o “Mercado Pago payments for WooCommerce”, disponível no repositório WordPress.org. A versão atual é a 6.x e exige WooCommerce 6.0 ou superior. Instale pela área de plugins do painel WordPress normalmente.

Após ativar, vá em WooCommerce > Configurações > Pagamentos. As opções do Mercado Pago aparecem separadas: Checkout Pro, Checkout Transparente e PIX. Ative especificamente o PIX.

A conexão com a conta é feita por OAuth, não por chave de API digitada manualmente. Clique em “Conectar conta”, faça login no Mercado Pago e autorize o acesso. As credenciais de produção e sandbox são geradas automaticamente.

Um detalhe que a documentação oficial não enfatiza: para o PIX funcionar no Mercado Pago, a conta precisa estar verificada e ter CPF ou CNPJ cadastrado. Conta não verificada retorna erro 400 na geração do QR Code. Parece bug do plugin, mas não é. É restrição de compliance da plataforma.

O prazo de expiração do PIX vem configurado como 30 minutos por padrão. Para produtos digitais, esse tempo funciona. Para produtos sob encomenda ou personalizados, estenda para pelo menos 24 horas. Pedimos para um cliente nosso que vende móveis planejados aumentar esse prazo para 72 horas. A taxa de pagamentos concluídos subiu 18% no mês seguinte.

Configurando PIX com PagSeguro no WooCommerce

O plugin oficial do PagSeguro se chama “PagBank for WooCommerce”, anteriormente conhecido como “WooCommerce PagSeguro”. A versão recomendada é a 4.x. A instalação segue o mesmo caminho: repositório WordPress.org, instalar e ativar.

A diferença em relação ao Mercado Pago está nas credenciais. O PagBank usa tokens de integração gerados diretamente no painel da plataforma. Para testes, acesse sandbox.pagseguro.uol.com.br. Para produção, use pagseguro.uol.com.br. Em ambos, vá em Minha Conta > Integrações > Credenciais e gere o token.

Com o token gerado, acesse WooCommerce > PagBank > Configurações e cole o e-mail da conta junto com o token. O plugin valida as credenciais automaticamente na sequência.

Para ativar o PIX especificamente, habilite o método “PIX” dentro das configurações do plugin. Dá para configurar uma mensagem personalizada na página de pagamento e ajustar o prazo de validade do código PIX gerado.

Uma limitação real que você precisa saber antes de começar: o PIX no PagSeguro só está disponível para contas PJ ou MEI com CNPJ registrado na plataforma. Conta de pessoa física não tem acesso. Isso não é bug nem configuração errada, é uma restrição deliberada da plataforma.

A diferença técnica entre os dois gateways

Muita gente instala os dois plugins e estranha o comportamento diferente de cada um. É esperado.

O Mercado Pago gera um QR Code dinâmico embutido diretamente na página de confirmação do pedido. O cliente aponta a câmera do celular, sem precisar copiar nenhum código. O plugin usa JavaScript para atualizar o status do pedido em tempo real via webhook: assim que o pagamento é confirmado, o pedido muda automaticamente para “Processando”.

O PagSeguro funciona de forma parecida, mas oferece também o “copia e cola” do código PIX além do QR Code. Para clientes que usam aplicativos de banco mais antigos ou com câmera limitada, essa opção faz diferença prática.

A configuração de webhooks é onde mais projetos quebram. Os dois gateways precisam enviar notificações para a URL do seu WooCommerce quando um pagamento é confirmado. O endereço padrão segue o padrão yoursite.com/wc-api/[nome_do_gateway]. Se o servidor tiver firewall restritivo ou o SSL não estiver configurado corretamente, o webhook não chega e o pedido fica travado em “Aguardando pagamento” mesmo depois que o cliente pagou.

O erro mais comum que vemos nas configurações de PIX

Há um equívoco que aparece repetidamente: a ideia de que ter uma conta ativa no gateway resolve tudo. Não resolve. Existem pré-requisitos que a documentação oficial menciona de passagem e que causam problemas na largada.

No Mercado Pago, a conta precisa ter limite de recebimento por PIX aprovado. Contas novas ou não verificadas têm limite zero. O desbloqueio exige envio de documentos e pode levar até 48 horas úteis. Já atendemos clientes que ficaram dois dias achando que o plugin estava com defeito quando o problema era esse.

No PagSeguro, além da obrigatoriedade de conta PJ, a loja precisa ter ao menos uma venda realizada pela plataforma antes de ativar o PIX em produção. Regra de compliance interna, não bug.

Outra situação frequente: o PIX funciona no sandbox mas não em produção. Quase sempre é questão de credenciais trocadas, as de sandbox no lugar das de produção, ou de domínio não aprovado pela plataforma. Sempre verifique qual ambiente está ativo nas configurações do plugin antes de abrir chamado de suporte.

Testando e monitorando a integração

Antes de liberar o PIX para clientes reais, teste o fluxo completo em modo sandbox. Os dois gateways oferecem ambientes de teste com contas simuladas.

No Mercado Pago, o ambiente de teste usa credenciais separadas disponíveis no painel de desenvolvedores em developers.mercadopago.com.br. Você encontra contas de teste pré-criadas, comprador e vendedor, para simular pagamentos do início ao fim.

No PagSeguro, o sandbox fica em sandbox.pagseguro.uol.com.br e segue a mesma lógica: credenciais próprias e contas de teste separadas do ambiente de produção.

Depois de ir a produção, monitore os logs em WooCommerce > Status > Logs. Filtre pelos logs dos plugins de pagamento. Qualquer erro de webhook aparece ali. Vale também instalar o plugin “WP Crontrol” para verificar se os cron jobs do WooCommerce que processam notificações de pagamento estão rodando. Para operações maiores, configure alertas por e-mail ou Slack para pedidos que ficam em “Aguardando pagamento” por mais de 1 hora. Isso identifica problemas de webhook antes que o cliente chegue reclamando.

Mercado Pago ou PagSeguro: qual escolher

Depende do perfil da operação. O Mercado Pago tem integração mais fluida e documentação melhor para quem vai mexer no código. O PagSeguro tem suporte telefônico mais acessível e é preferido por quem já usa o ecossistema PagBank para outros serviços financeiros da empresa.

Para lojas menores que estão começando, o Mercado Pago costuma ser a escolha mais prática. A curva de configuração é menor e o suporte via chat resolve os problemas mais comuns em menos de um dia. Para operações maiores com necessidade de conciliação financeira detalhada, o PagSeguro oferece relatórios mais completos e integração com sistemas ERP mais fácil de configurar.

Usar os dois ao mesmo tempo também funciona, e é o que recomendamos para lojas que querem dar máxima flexibilidade ao cliente sem aumentar fricção no checkout. O WooCommerce suporta múltiplos gateways ativos simultaneamente sem conflito, desde que os plugins sejam de fornecedores distintos.

Perguntas frequentes

Como ativar PIX no WooCommerce com Mercado Pago?

Instale o plugin “Mercado Pago payments for WooCommerce” pelo repositório WordPress.org, conecte a conta via OAuth em WooCommerce > Configurações > Pagamentos e ative a opção de PIX separadamente. A conta Mercado Pago precisa estar verificada com CPF ou CNPJ cadastrado para que a geração do QR Code funcione em produção.

Por que o PIX aparece no sandbox mas não funciona em produção?

Quase sempre o motivo é credenciais trocadas: as chaves de sandbox sendo usadas no ambiente de produção, ou vice-versa. Verifique nas configurações do plugin qual ambiente está selecionado. Outro motivo comum é conta não verificada no gateway, o que bloqueia transações reais mesmo com o plugin configurado corretamente.

Posso usar Mercado Pago e PagSeguro ao mesmo tempo no WooCommerce?

Sim. O WooCommerce permite múltiplos gateways ativos simultaneamente. O cliente vê os dois como opções no checkout e escolhe qual prefere. Não há conflito entre os plugins desde que ambos sejam mantidos atualizados e com credenciais corretas para cada ambiente.

O pedido fica parado em “aguardando pagamento” mesmo depois que o cliente pagou. O que fazer?

Esse é o sintoma clássico de webhook não recebido. Verifique se a URL de notificação está acessível externamente, se o SSL está válido e se nenhuma regra de firewall bloqueia requisições externas para yoursite.com/wc-api/. Cheque também os logs em WooCommerce > Status > Logs para ver a mensagem de erro específica do gateway.

O PagSeguro PIX funciona para pessoa física?

Não. O PIX no PagSeguro está disponível apenas para contas PJ ou MEI com CNPJ registrado na plataforma. Contas de pessoa física não têm acesso a essa funcionalidade, independente de configuração ou plano contratado.

Está configurando PIX no WooCommerce pela primeira vez ou tem uma integração que não funciona como deveria? A equipe da Weboption trabalha com integrações de gateway para WooCommerce há mais de 10 anos. Conhecemos os pontos cegos que a documentação oficial não cobre. Fale com a gente em weboption.com.br/contato.