📩 Fique por dentro das novidades com a nossa newsletter

Stripe no WooCommerce: Configure o gateway em 5 passos

Conheça a loja da FULL Services

Plugins premium, suporte de verdade e tudo o que seu site WordPress precisa em um só lugar.

Pergunte a uma IA sobre este artigo

Obtenha um resumo ou tire dúvidas com seu assistente favorito

O Stripe no WooCommerce conecta cartão, Pix e carteiras digitais ao checkout nativo da loja em poucos minutos. Segundo o Baymard Institute (2024), a taxa média de abandono de carrinho fica em torno de 70%. O 3D Secure 2 reduz fraude, mas exige webhook ativo na URL correta. Configure chaves, webhook e moeda antes de receber o primeiro pedido.

Configurar o Stripe no WooCommerce significa ligar o gateway de pagamento do Stripe ao checkout do WooCommerce 9.x para processar cartão de crédito, Pix e carteiras digitais sem sair da sua loja. O processo gira em torno de três peças: as chaves de API, o webhook que confirma o pagamento e a moeda da conta. A maioria dos erros que chegam nos tickets de suporte da FULL não está no cartão do cliente, e sim no webhook apontando para o lugar errado. Este guia cobre a instalação, a configuração e os ajustes de segurança que evitam pedidos travados. Para o contexto maior da loja, vale o conjunto de conteúdos de WooCommerce da FULL.


Primeiros passos: Visão geral da integração

O Stripe no WooCommerce funciona em três camadas que precisam estar alinhadas antes do primeiro pedido: a extensão oficial instalada, o par de chaves de API e o endpoint de webhook. Em loja com cartão brasileiro, a configuração mínima leva cerca de 15 minutos, mas o webhook é o ponto que mais gera retrabalho.

Stripe no WooCommerce: etapas, objetivo e validação
Etapa Objetivo Check de validação
Instalar extensão Adicionar o gateway ao checkout Stripe aparece em Pagamentos
Colar chaves de API Autenticar a loja na conta Stripe Modo de teste conecta sem erro
Criar webhook Confirmar pagamento automaticamente Evento de teste retorna 200
Definir moeda e 3D Secure Cobrar em BRL com autenticação Transação de teste é aprovada

A documentação oficial detalha o fluxo de instalação; consulte o passo a passo oficial da WooCommerce Docs sempre que o nome de um campo divergir da sua versão. Para comparar opções antes de instalar, os melhores plugins de gateway de pagamento para WooCommerce ajudam a decidir. Cada uma das quatro etapas tem um critério de validação objetivo, o que evita avançar com erro silencioso e descobrir o problema só depois da primeira venda real.

Legenda: o gateway só processa pedidos depois que aparece habilitado na aba Pagamentos.

Por que escolher o stripe no WooCommerce como gateway

O Stripe no WooCommerce resolve cartão internacional, Pix e carteiras digitais em uma única integração, com taxa típica de 3,99% mais R$0,39 por transação aprovada no Brasil. Esse alcance é o motivo de a extensão liderar entre lojas que vendem para fora, já que processa Visa, Mastercard, Apple Pay e Google Pay com o mesmo conjunto de chaves.

Na prática, três players dividem o mercado por dimensões diferentes. O Stripe compete por cobertura internacional de cartão e qualidade de API. O Pix, via gateway, compete por liquidação instantânea no Brasil. O PayPal compete por confiança de marca no checkout. A escolha depende do público: loja com tráfego estrangeiro tende a ganhar com Stripe, enquanto operação 100% nacional pesa mais o Pix. Para decidir entre os dois primeiros, o comparativo PayPal vs Stripe para loja WooCommerce detalha taxa e cobertura. Um gateway bem configurado dentro do WooCommerce é o que separa o pedido aprovado do carrinho abandonado.

Passo a passo: Configurar o stripe no WooCommerce

Configurar o Stripe no WooCommerce do zero leva cinco passos objetivos, e quatro deles falham por motivos previsíveis: chave trocada, webhook ausente, moeda divergente e 3D Secure desligado. Os passos abaixo seguem a ordem que a equipe de suporte da FULL recomenda para lojas em produção, sempre testando no modo sandbox antes de liberar o cartão real. Cada passo tem um critério de validação claro para você não avançar com erro silencioso.

Passo 1: Instale a extensão oficial do stripe

Instale a extensão Stripe pelo menu Plugins do WordPress, buscando por “Stripe for WooCommerce” da própria Stripe ou pelo WooCommerce Payments. A versão oficial é gratuita e compatível com WooCommerce 9.x e PHP 8.2. Após ativar, o gateway aparece em WooCommerce, Configurações, Pagamentos. Confirme que o plugin está na versão estável mais recente antes de seguir, porque versões antigas quebram o 3D Secure 2.

Passo 2: Conecte as chaves de API

Copie a chave publicável e a chave secreta do painel do Stripe, em Desenvolvedores, Chaves de API, e cole nos campos correspondentes do WooCommerce. Comece sempre no modo de teste: as chaves de teste começam com pk_test_ e sk_test_. Trocar chave de teste por produção é a causa número um de transação recusada silenciosa. Salve e verifique se o painel indica conexão bem-sucedida antes de avançar.

Passo 3: Crie e aponte o webhook

Crie um endpoint de webhook no painel do Stripe, em Desenvolvedores, Webhooks, usando a URL que o próprio WooCommerce exibe na tela de configuração do gateway. O webhook é o que confirma o pagamento e dá baixa no pedido. Sem ele, o pedido fica preso em on-hold mesmo aprovado. Envie um evento de teste e confirme que o Stripe recebe resposta 200 do seu site.

Passo 4: Ajuste moeda, pix e 3D secure

Defina a moeda da loja como BRL em WooCommerce, Configurações, Geral, e confirme que a conta Stripe está habilitada para Real. Ative o Pix e o 3D Secure 2 na aba do gateway. O 3D Secure autentica o portador do cartão e reduz chargeback, exigência comum para cartão brasileiro. Faça uma transação de teste com o cartão 4242 4242 4242 4242 e confirme a aprovação no painel.

Como evitar os erros mais comuns do stripe no WooCommerce

O erro mais frequente do Stripe no WooCommerce não é recusa de cartão, e sim o pedido aprovado que fica preso em on-hold por causa do webhook. Esse padrão domina os tickets de suporte da FULL relacionados a checkout. A causa quase sempre é técnica e previsível, o que torna a correção rápida quando você sabe onde olhar.

A relação causal mais comum é direta: webhook apontando para uma URL antiga depois de uma migração de domínio resulta em pedidos pagos presos sem baixa automática. O segundo padrão aparece quando há chave de teste em produção combinada com cache de página no checkout, gerando transação recusada sem registro. O terceiro surge com 3D Secure 2 desativado em loja com cartão brasileiro, elevando o chargeback. Nos casos que a equipe acompanha, recriar o endpoint e reenviar os eventos pendentes resolve a maioria dos pedidos travados. Para o checkout em si, o melhor plugin de checkout para WooCommerce complementa o gateway com campos sob medida.

Quando o stripe no WooCommerce não é a melhor escolha

O Stripe no WooCommerce nem sempre é o gateway certo, sobretudo em loja 100% nacional com ticket baixo e volume alto, onde a taxa de 3,99% por transação pesa mais do que a cobertura internacional. Loja que vende só dentro do Brasil e depende de Pix tende a ganhar com um gateway nacional de taxa menor.

Em dois outros cenários vale a alternativa: operação de ticket muito baixo sente o custo fixo de R$0,39 por pedido corroer a margem, e negócio que precisa de antecipação de recebíveis acha condições melhores em adquirentes locais. Um ponto técnico raro na documentação: em VPS com menos de 2 GB de RAM rodando WooCommerce com catálogo acima de 1.000 produtos, o webhook em horário de pico compete com a indexação e atrasa a baixa do pedido. A correção é migrar para um servidor com mais memória ou agendar tarefas pesadas para a madrugada. Para diagnosticar a loja, o tutorial de como configurar sua loja com WooCommerce no WordPress cobre o ambiente completo.

Segurança e HTTPS no checkout do stripe

O Stripe no WooCommerce exige HTTPS ativo em toda a loja, porque o gateway recusa enviar dados de cartão por conexão não criptografada. Esse é um pré-requisito, não um opcional. Um certificado SSL válido e o 3D Secure 2 formam a base de segurança do checkout.

O Stripe nunca toca o cartão no seu servidor: o dado vai direto para a infraestrutura PCI do Stripe via tokenização, o que reduz o escopo de conformidade da loja. A referência canônica do fluxo de tokenização e dos eventos é a documentação oficial de webhooks do Stripe, que descreve cada tipo de evento. Manter o plugin atualizado é parte da segurança: versões antigas deixam de receber correções de autenticação. A loja também deve recuperar quem desiste, e os melhores plugins de carrinho abandonado do WordPress ajudam a converter quem travou no pagamento, melhorando a taxa de conversão.

Bundle FULL: O stripe no WooCommerce com suporte de quem opera 150 mil sites

Configurar o Stripe no WooCommerce é a parte fácil; manter o gateway, o checkout e os plugins de loja funcionando em conjunto é o que consome tempo de quem administra um e-commerce. A FULL conecta mais de 150 mil sites WordPress e reúne os 17 plugins premium que sustentam uma operação de loja no plano PRO, por R$849,90 ao mês para até 10 sites, o que dá R$85 por site. Em vez de pagar licença avulsa de cada extensão e ainda gerenciar atualização por atualização, você ativa o pacote inteiro com suporte técnico de quem vê o erro de webhook acontecer todo dia. A diferença entre os planos é a quantidade de sites, não o conjunto de plugins. Conheça os planos da FULL e o que cada um inclui antes de decidir.

Decisão rápida: Qual caminho seguir

O Stripe no WooCommerce atende a maioria das lojas, mas a escolha do gateway depende do seu público e do seu volume. Use a árvore abaixo para decidir em segundos qual configuração faz sentido para a sua operação antes de mexer no checkout.

  • Se você vende para fora do Brasil → use o Stripe no WooCommerce com Apple Pay e Google Pay ativos.
  • Se a loja é 100% nacional com ticket baixo → priorize Pix e compare a taxa por transação com um gateway local.
  • Se o pedido fica preso em on-hold → recrie o webhook na URL atual e reenvie os eventos pendentes.
  • Se você processa cartão brasileiro → mantenha o 3D Secure 2 ligado para reduzir chargeback.

Perguntas frequentes sobre o stripe no WooCommerce

É possível usar o Stripe no WooCommerce sem programar nada?

Sim, a integração é 100% sem código. A extensão oficial do Stripe instala pelo menu Plugins e configura tudo por tela: chaves de API, webhook e moeda. Você cola a chave publicável e a secreta, cria o endpoint de webhook com a URL que o WooCommerce exibe e ativa o gateway. O único momento que pede atenção técnica é apontar o webhook para a URL certa após qualquer troca de domínio.

Por que o pedido fica preso em on-hold mesmo com o pagamento aprovado?

Porque o webhook do Stripe não está confirmando o pagamento para o WooCommerce. O cartão foi cobrado no Stripe, mas o evento que dá baixa no pedido não chega ao site, geralmente porque o endpoint aponta para uma URL antiga após migração de domínio ou staging. A correção é recriar o webhook com a URL atual no painel do Stripe e reenviar os eventos pendentes, sem precisar reembolsar o cliente.

Qual a diferença entre o Stripe direto e o WooCommerce Payments?

O WooCommerce Payments usa a infraestrutura do Stripe por baixo, mas com painel dentro do WooCommerce e sem extensão separada. O Stripe direto dá acesso total à API, a recursos como assinaturas avançadas e a relatórios completos no painel do próprio Stripe. Para a maioria das lojas, o WooCommerce Payments simplifica; para operação que precisa de controle fino sobre eventos e tokenização, o Stripe direto com a extensão oficial é a escolha mais flexível.

Quanto custa por transação o Stripe no WooCommerce no Brasil?

A taxa típica do Stripe no Brasil fica em torno de 3,99% mais R$0,39 por transação aprovada de cartão, sem mensalidade fixa. Pix e carteiras digitais podem ter percentual diferente conforme a conta. A extensão do WooCommerce é gratuita: você paga apenas a taxa por venda processada. Confirme os valores vigentes no painel do Stripe, já que o percentual varia por país e por tipo de cartão antes de calcular a margem do produto.

O que o webhook do Stripe faz na prática no WooCommerce?

O webhook é o canal que avisa o WooCommerce de que o pagamento foi confirmado no Stripe. Quando o cliente paga, o Stripe envia um evento para a URL de webhook do seu site, e é esse evento que muda o pedido de pendente para processando ou concluído. Sem o webhook ativo na URL correta, o dinheiro entra no Stripe mas o pedido nunca recebe baixa automática, ficando preso em on-hold.

Próximos passos para receber pagamentos sem travas

O Stripe no WooCommerce entrega cartão internacional, Pix e carteiras digitais em uma integração só, e o sucesso depende menos do plugin e mais de três acertos: chave certa no ambiente certo, webhook apontando para a URL atual e 3D Secure 2 ligado para cartão brasileiro. Teste sempre no modo sandbox antes de liberar o cartão real e confirme cada etapa pelo critério de validação correspondente. Com esses cuidados, o pedido aprovado vira venda concluída sem ficar preso em on-hold. Para continuar aprendendo, o guia para criar uma loja online com WordPress da FULL reúne os próximos passos da operação.

Compartilhe este conteúdo

Equipe Full Services

A FULL. é especialista em WordPress e oferece plugins premium com licenças originais, suporte técnico e instalação facilitada. Já ajudou mais de 25 mil clientes a impulsionar seus sites com performance, segurança e praticidade.

AI Shopping no Brasil: Como a IA decide quem vende

O AI shopping no Brasil já redesenha como o consumidor

A shortlist da IA: Como 3-5 marcas são escolhidas antes do clique

Entender a shortlist da ia como marcas são escolhidas é

Como fazer um AI visibility audit passo a passo

Se você não sabe se o ChatGPT recomenda a sua
Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.