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