Pagamento Stripe WPForms não processa: como corrigir

Tipo Outros erros

Nome do erro Stripe/PayPal não processa pagamentos no WPForms EN: WPForms Stripe/PayPal payment not processing

Severidade Crítico

Descrição O pagamento Stripe ou PayPal não processa no WPForms quando o formulário envia mas a cobrança não acontece, é recusada ou fica pendente. As causas reais costumam ser SSL ausente na página, modo Teste ligado em produção, AJAX desabilitado, licença Pro inativa ou o campo de pagamento faltando no formulário.

O que é o pagamento Stripe ou PayPal que não processa no WPForms?

No WPForms, pagamentos por cartão (Stripe) ou PayPal são processados por addons Pro que conectam o formulário à conta do gateway e cobram o valor de um campo de itens de pagamento. A falha de processamento é quando o visitante preenche e envia o formulário, mas a transação não é criada no Stripe/PayPal: nenhuma cobrança aparece, o cartão é recusado por configuração, ou o envio acontece sem que o valor seja debitado. Diferente de um formulário comum, o pagamento exige requisitos extras (SSL, conexão de conta, AJAX e campos específicos) que, quando faltam, fazem o envio parecer bem-sucedido sem cobrar nada.

Como identificar

Mensagem no formulário do tipo ‘There was a problem processing your payment’ ou ‘Não foi possível processar o pagamento’ após clicar em enviar.
O formulário é enviado e mostra a confirmação, mas nenhuma cobrança aparece no painel da Stripe ou do PayPal.
O campo de cartão (Stripe Credit Card field) não carrega, fica em branco ou não aceita o número do cartão.
No painel da Stripe a cobrança aparece como Test mode (test) enquanto a loja deveria estar cobrando de verdade.
Em WPForms -> Pagamentos a entrada some ou fica marcada como pendente, sem virar pagamento concluído.

Antes de começar: Nunca cole a chave secreta (secret key) da Stripe no front-end, em snippets públicos ou em logs versionados. Teste sempre com chaves de Test/Sandbox em ambiente de staging antes de mexer na conexão de produção, e use um valor baixo no primeiro pedido real.

Como prevenir

Mantenha a licença Pro ativa e o WPForms com os addons Stripe Pro e PayPal sempre atualizados para a versão mínima exigida.
Documente qual conta está conectada e em qual modo (Live x Test), e nunca deixe Test Mode marcado em produção.
Teste cada formulário de pagamento com uma transação real de valor baixo após qualquer atualização de plugin, tema ou troca de host.

Causa

SSL/HTTPS ausente na página onde o formulário está publicado: a Stripe exige HTTPS para coletar dados de cartão e bloqueia a cobrança em página sem cadeado válido.
Modo Teste (Test) ainda ligado em produção, ou chaves de Test e Live conectadas trocadas: Stripe exige conectar Test e Live separadamente via Stripe Connect e o PayPal exige sair do Sandbox.
Envios AJAX desabilitados no formulário: o addon Stripe só funciona com 'Enable AJAX form submission' ativo em Configurações -> Geral do formulário.
Licença do WPForms inativa ou abaixo de Pro: os addons Stripe Pro e PayPal exigem licença Pro ou superior, e licença inativa ainda aplica taxa extra de 3% por transação.
Campo de pagamento faltando no formulário: sem um campo de itens (Single Item, Multiple Items, Dropdown ou Checkbox Items) com valor e sem o Stripe Credit Card field, não há valor para cobrar.
Versão do WPForms ou do addon desatualizada: o addon Stripe Pro exige a versão mínima do WPForms, e webhooks só são autoconfigurados a partir da versão 1.8.4.

Como resolver

Garanta SSL válido na página do formulário: confirme que a página onde o formulário está publicado abre em HTTPS com cadeado válido. A Stripe recusa coletar cartão sem SSL. Force HTTPS no site inteiro caso a página de pagamento ainda abra em HTTP.
```
Settings -> General -> WordPress Address (URL) e Site Address (URL) começando com https://
```
Conecte a conta e desligue o modo Teste: reconecte a conta do gateway e confirme o modo de produção. Apenas administradores conseguem conectar via Stripe Connect, e Test e Live são conexões separadas.
```
WPForms -> Configurações -> Pagamentos -> Stripe -> Connect with Stripe
Modo: Live (desmarcar Test Mode)
PayPal: WPForms -> Configurações -> Pagamentos -> PayPal -> Mode: Production (não Sandbox)
```
Adicione os campos de pagamento obrigatórios no formulário: abra o construtor do formulário e garanta os três componentes que o addon exige: um campo Email, um campo de itens de pagamento com valor e o campo de cartão da Stripe.
```
Email field
Single Item / Multiple Items / Dropdown Items / Checkbox Items (com preço)
Stripe Credit Card field
```
Habilite o AJAX e a ação de pagamento: o addon Stripe só dispara a cobrança com envio AJAX ativo, e a ação de pagamento precisa estar habilitada na aba Pagamentos do formulário para o valor ser enviado ao gateway.
```
Construtor -> Configurações -> Geral -> Enable AJAX form submission
Construtor -> Pagamentos -> Stripe -> Enable Stripe payments
Construtor -> Pagamentos -> PayPal -> Enable PayPal payments
```
Atualize, valide a licença e faça um pedido de teste real: atualize o WPForms e os addons, confirme a licença Pro ativa e faça uma transação real de valor baixo para validar o fluxo de ponta a ponta. Se o webhook não autoconfigurar, recadastre o endpoint manualmente na conta da Stripe.
```
WPForms -> Configurações -> Geral -> License Key (status: Active)
Plugins -> WPForms -> Update / Addons -> Stripe Pro -> Update
Stripe Dashboard -> Developers -> Webhooks (endpoint do WPForms ativo)
```

PHP

<?php
// functions.php do tema filho — registra no log do WordPress quando o WPForms
// processa um pagamento Stripe, para diagnosticar cobranca que nao acontece.
add_action( 'wpforms_stripe_process_payment_total', function ( $amount, $form_data ) {
    error_log( sprintf(
        '[WPForms Stripe] form #%d | total cobrado: %s',
        isset( $form_data['id'] ) ? (int) $form_data['id'] : 0,
        $amount
    ) );
}, 10, 2 );
// Se o formulario eh enviado mas NADA aparece no debug.log, o fluxo de pagamento
// nem inicia: cheque AJAX, modo Live e o campo de itens de pagamento no formulario.

Perguntas frequentes

O formulário envia mas a cobrança não aparece na Stripe. Por quê?

Quase sempre o formulário está com AJAX desabilitado ou em modo Teste. O addon Stripe só cobra com 'Enable AJAX form submission' ativo, e cobranças em Test Mode não geram pagamento real. Ative o AJAX, desligue o Test Mode e confirme que a ação de pagamento está habilitada na aba Pagamentos.

Preciso de SSL para receber pagamento no WPForms?

Sim. A Stripe exige HTTPS na página onde o formulário coleta o cartão e recusa processar sem SSL válido. Instale um certificado, force HTTPS no site inteiro e confirme o cadeado na página antes de publicar o formulário de pagamento.

Qual licença do WPForms é necessária para Stripe e PayPal?

Os addons Stripe Pro e PayPal exigem licença Pro ou superior. Com a licença inativa, além de o addon poder não funcionar, a Stripe aplica uma taxa extra de 3% por transação além da taxa padrão do gateway. Confirme a licença ativa em WPForms -> Configurações -> Geral.

Por que o campo de cartão da Stripe não aparece no formulário?

O campo não aparece quando o Stripe Credit Card field não foi adicionado, quando falta um campo de itens de pagamento com valor, ou quando há conflito de JavaScript/cache. Adicione o campo de cartão, um campo de itens com preço e limpe o cache da página para o campo renderizar.

Estou cobrando em modo de teste sem querer. Como saber?

No painel da Stripe a transação aparece marcada como 'test'. No WPForms, confira em Configurações -> Pagamentos se a conexão está em Live e se o Test Mode do formulário está desmarcado. Test e Live são conexões separadas no Stripe Connect, então reconecte no modo Live.

O PayPal não processa o pagamento. O que verificar primeiro?

Confirme que o modo está em Production e não Sandbox, que a conta PayPal foi conectada corretamente e que existe um campo de itens de pagamento com valor no formulário. Sem um valor a cobrar e com a conta em Sandbox, o envio acontece sem gerar pagamento real.

Atualizei o WPForms e os pagamentos pararam. O que fazer?

O addon de pagamento pode estar abaixo da versão mínima exigida. Atualize o WPForms e os addons Stripe Pro e PayPal, reconecte a conta se necessário e faça um pedido de teste real. A partir da versão 1.8.4 os webhooks da Stripe são autoconfigurados ao reconectar a conta.

O cliente paga mas a entrada fica pendente no WPForms. Por quê?

Geralmente o webhook da Stripe não chegou ao site ou a autoconfiguração falhou. Reconecte a conta para reconfigurar o webhook ou cadastre o endpoint manualmente em Developers -> Webhooks no painel da Stripe, e confirme que nenhum firewall/WAF bloqueia essa rota.

Grave

Como corrigir quizzes que não salvam respostas no Tutor LMS

No Tutor LMS, o quiz não salvar respostas significa que o aluno envia mas a tentativa não aparece em Quiz Attempts ou vem com respostas em branco. Quase sempre vem de tabelas customizadas ausentes no banco, do limite max_input_vars estourado, ou do AJAX do Tutor bloqueado por segurança ou cache.

Informativo

Como corrigir notificações de Q&A que não chegam aos instrutores no Tutor LMS

As notificações de Q&A do Tutor LMS não chegam aos instrutores quando o addon Email do Tutor LMS Pro está desligado, o gatilho New Q&A Message está desmarcado ou o site não tem um SMTP configurado para entregar o e-mail disparado quando o aluno faz uma pergunta.

Grave

Como corrigir o Course Builder que não carrega no Tutor LMS

Quando o Course Builder não carrega no Tutor LMS, o editor de curso fica preso no spinner, abre em branco ou retorna nonce inválido. A causa quase sempre é minificação agressiva de JavaScript por plugin de cache ou conflito de plugin SEO que quebra o painel.

Grave

Como corrigir o mapeamento de campos no User Registration do WPForms

O mapeamento de campos no User Registration do WPForms falha quando os dropdowns em Settings -> User Registration não apontam para os campos certos do formulário, quando o campo Email obrigatório esta ausente ou quando a Meta Key de um custom user meta não casa com o nome real do campo, fazendo os dados não chegarem ao perfil do usuário.

Grave

Como corrigir e-mails de notificação que não chegam no Tutor LMS

No Tutor LMS, os e-mails automáticos como matrícula, boas-vindas e conclusão de curso não chegam aos alunos nem aos instrutores. A causa quase sempre está no addon Email Notifications desativado, nos gatilhos de e-mail desligados ou no wp_mail do WordPress sem SMTP autenticado caindo em spam.

Atenção

Como corrigir o feed RSS com erro no WordPress

O erro no feed RSS do WordPress aparece quando o navegador ou validador mostra uma falha de XML, normalmente porque há espaço ou texto antes da abertura do feed. A correção é localizar a saída extra (functions.php, wp-config.php ou plugin) e remover o espaço em branco antes da tag de XML.

Setores

Extensões

Integrações

Como corrigir a integração Stripe/PayPal que não processa pagamentos no WPForms

O que é o pagamento Stripe ou PayPal que não processa no WPForms?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir quizzes que não salvam respostas no Tutor LMS

Como corrigir notificações de Q&A que não chegam aos instrutores no Tutor LMS

Como corrigir o Course Builder que não carrega no Tutor LMS

Como corrigir o mapeamento de campos no User Registration do WPForms

Como corrigir e-mails de notificação que não chegam no Tutor LMS

Como corrigir o feed RSS com erro no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos