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.
| 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.
















