Pagamento Tutor LMS WooCommerce: como corrigir

Tipo WooCommerce

Nome do erro Pagamento do Tutor LMS com WooCommerce não funciona EN: Tutor LMS WooCommerce payment not working

Severidade Crítico

Descrição O erro de pagamento do Tutor LMS com WooCommerce ocorre quando o aluno compra um curso, o pedido entra no WooCommerce, mas a matricula não acontece e ele fica sem acesso. A causa quase sempre e o pedido não atingir o status Concluido, o produto do curso não ser virtual, ou a engine de monetizacao errada nas Configurações.

O que é o erro de pagamento do Tutor LMS com WooCommerce?

No Tutor LMS, quando a engine de monetizacao esta definida como WooCommerce, a venda do curso passa a ser um pedido do WooCommerce. A matricula do aluno não e disparada no momento do pagamento: ela so e liberada quando o pedido atinge o status que o Tutor LMS reconhece como pago. O erro de pagamento do Tutor LMS com WooCommerce e exatamente essa quebra no fluxo: o cliente paga, o pedido fica preso em Processando ou Aguardando, e o curso nunca aparece na conta do aluno. Também entra nesse erro o caso em que o método de pagamento nem chega a aparecer na finalizacao, porque a integração ou o produto do curso estão mal configurados.

Como identificar

O aluno conclui o pagamento, mas o curso não aparece em Meus Cursos e ele continua vendo o botão ‘Comprar’ em vez de ‘Continuar’.
No painel, o pedido do curso fica preso em ‘Processando’ ou ‘Aguardando pagamento’ e nunca muda para ‘Concluido’.
Mensagem ‘Nenhum método de pagamento disponível’ ou ausencia de gateway na página de finalizacao do curso.
Em WooCommerce > Status > Logs não ha registro de matricula, e o curso comprado continua marcado como ‘Pago’ (não matriculado) para aquele usuário.

Como prevenir

Sempre que criar um curso pago, marque o produto como Virtual e For Tutor antes de publicar, e valide com um pedido de teste
Mantenha apenas uma engine de monetizacao ativa no Tutor LMS para evitar conflito entre WooCommerce e a engine nativa
Após cada atualização do Tutor LMS ou do WooCommerce, refaca um pedido de teste para confirmar que a matricula automática continua disparando

Causa

A opção 'Automatically Complete WooCommerce Orders' esta desligada em Tutor LMS > Configurações > Monetizacao, entao o pedido fica em Processando e a matricula, que depende do status Concluido, nunca dispara.
O produto WooCommerce ligado ao curso não esta marcado como Virtual nem com a opção 'For Tutor', fazendo o WooCommerce tratar a compra como item fisico e cobrar frete ou travar o checkout.
A engine de monetizacao em Tutor LMS > Configurações > Monetizacao não esta definida como WooCommerce (ou ha duas engines ativas, o que a doc proibe: apenas uma engine pode operar por vez).
O curso esta marcado como 'Paid' mas sem nenhum produto WooCommerce selecionado no campo 'Add Product', deixando a compra sem pedido associado.
Nenhum método de pagamento ativo em WooCommerce > Configurações > Pagamentos, entao a venda do curso não pode ser concluida (a doc avisa: nenhuma transação ocorre sem método configurado).

Como resolver

Confirme a engine de monetizacao: abra o painel e garanta que a engine de venda esta definida como WooCommerce, e apenas ela. Use o caminho de menu abaixo. Apenas uma engine pode operar por vez, segundo a documentação do Tutor LMS.
```
Tutor LMS -> Configurações -> Monetizacao -> eCommerce Engine = WooCommerce
```
Ative o auto-completar do pedido: ligue a opção que conclui o pedido automaticamente. Sem isso o pedido fica em Processando e a matricula, que so dispara no status Concluido, não acontece. Marque também o redirecionamento para o curso.
```
Tutor LMS -> Configurações -> Monetizacao -> Automatically Complete WooCommerce Orders = ON
Tutor LMS -> Configurações -> Monetizacao -> Auto Redirect to Courses = ON
```
Corrija o produto do curso: edite o produto WooCommerce ligado ao curso e marque-o como Virtual e com a opção For Tutor. Produto fisico cobra frete e pode travar o checkout do curso.
```
Produtos -> [produto do curso] -> Dados do produto -> marcar 'Virtual'
Produtos -> [produto do curso] -> marcar a opção 'For Tutor'
```
Religue produto e método de pagamento: no editor do curso, confirme que ele esta como Paid e com o produto certo selecionado em Add Product. Depois ative ao menos um método de pagamento no WooCommerce. Sem método ativo, nenhuma transação ocorre.
```
Cursos -> [curso] -> Add Product -> Paid -> selecionar o produto
WooCommerce -> Configurações -> Pagamentos -> ativar ao menos um método
```
Faca um pedido de teste real: com tudo configurado, compre o curso com um valor baixo para validar o fluxo de ponta a ponta. O pedido deve chegar a Concluido e o curso deve aparecer em Meus Cursos para o comprador.
```
WooCommerce -> Pedidos -> confirmar status 'Concluido' do pedido de teste
```

PHP

// functions.php do tema filho — matricula de emergencia quando o pedido fica
// preso em 'Processando' (status que o Tutor LMS nao reconhece como pago).
// Trata o pedido 'Processando' do curso como concluido, disparando a matricula.
add_action( 'woocommerce_order_status_processing', function ( $order_id ) {
    if ( ! function_exists( 'tutor_utils' ) ) {
        return; // Tutor LMS inativo: nao faz nada.
    }
    $order = wc_get_order( $order_id );
    foreach ( $order->get_items() as $item ) {
        $product_id = $item->get_product_id();
        // So conclui se o produto estiver ligado a um curso do Tutor LMS.
        if ( tutor_utils()->product_belongs_with_course( $product_id ) ) {
            $order->update_status( 'completed' );
            break;
        }
    }
}, 10, 1 );

Perguntas frequentes

O aluno pagou mas o curso não aparece para ele. Por que?

Porque o pedido do WooCommerce não atingiu o status Concluido, que e o gatilho da matricula no Tutor LMS. Ative 'Automatically Complete WooCommerce Orders' em Tutor LMS -> Configurações -> Monetizacao para que o pedido conclua sozinho e o aluno seja matriculado.

Onde defino que o Tutor LMS vende pelo WooCommerce?

Em Tutor LMS -> Configurações -> Monetizacao, no campo eCommerce Engine, selecione WooCommerce. A documentação avisa que apenas uma engine pode operar por vez, entao não deixe a engine nativa e o WooCommerce ativos juntos.

Por que o método de pagamento não aparece na finalizacao do curso?

Geralmente porque nenhum método esta ativo em WooCommerce -> Configurações -> Pagamentos, ou o produto do curso não esta vinculado. A doc do Tutor LMS e clara: nenhuma transação ocorre enquanto o método de pagamento não estiver configurado.

O produto do curso precisa ser Virtual?

Sim. O produto ligado ao curso deve ser marcado como Virtual e com a opção For Tutor. Se ficar como produto fisico, o WooCommerce tenta calcular frete e pode travar o checkout, impedindo a compra do curso.

O pedido fica preso em 'Processando'. Como resolver?

Esse status indica pagamento recebido mas pedido não concluido, e a matricula do Tutor LMS so dispara em 'Concluido'. Ligue 'Automatically Complete WooCommerce Orders' para que cursos virtuais pagos sejam concluidos automaticamente e o acesso seja liberado.

Posso usar a engine nativa e o WooCommerce ao mesmo tempo?

Não. A documentação do Tutor LMS afirma que múltiplas engines de eCommerce não funcionam ao mesmo tempo; apenas uma opera por vez. Escolha WooCommerce no campo eCommerce Engine e mantenha somente ela ativa para o fluxo de pagamento funcionar.

Atualizei o WooCommerce e os cursos pararam de matricular. O que fazer?

Refaca um pedido de teste e confira se o auto-completar e o vinculo produto-curso continuam ativos. Atualizações podem resetar configurações ou exigir versão compativel do Tutor LMS. Valide em staging antes de confirmar na loja ao vivo.

Crítico

Como corrigir o carrinho do WooCommerce que não funciona com o Elementor Pro

O cart do WooCommerce não funcionar com o Elementor Pro significa que o widget Menu Cart ou Cart mostra o contador parado em zero, não abre o painel lateral ou não soma o produto após o clique. Quase sempre vem dos fragments AJAX bloqueados por cache, do script wc-cart-fragments minificado, ou do tema sem suporte ao WooCommerce.

Atenção

Como corrigir o cupom de desconto que não funciona no WooCommerce

O cupom que não funciona no WooCommerce acontece quando o cliente digita o código de desconto e ele é recusado, não aplica o valor, ou o campo de cupom nem aparece no carrinho. Quase sempre vem dos cupons desativados nas configurações, de restrições de uso (valor mínimo, produtos, validade) ou de cache servindo um carrinho antigo.

Grave

Como corrigir a página de produto do WooCommerce que quebra com o Astra Pro

A product page do WooCommerce com Astra quebrar significa que a tela do produto abre com layout desalinhado, galeria empilhada ou botão de comprar fora do lugar. Quase sempre vem de template do WooCommerce desatualizado no tema filho, do módulo WooCommerce do Astra Addon desativado ou de um page builder assumindo a single product.

Grave

Como corrigir o estoque do WooCommerce mostrando errado

O estoque errado no WooCommerce acontece quando a quantidade exibida não bate com o real: produto disponível aparece esgotado, a contagem não baixa após a venda, ou somem unidades sem pedido. Quase sempre vem de cache antigo, de pedidos presos reduzindo estoque, ou de sincronização externa fora de hora.

Grave

Como corrigir o produto do WooCommerce com página em branco

O produto do WooCommerce com página em branco acontece quando a página de um produto abre totalmente vazia, sem texto, imagem ou botão de comprar. A causa quase sempre é um erro fatal de PHP silenciado, um template de produto ausente no tema, ou o limite de memória do PHP estourado ao renderizar a página.

Atenção

Como corrigir o cálculo de frete errado no WooCommerce

O cálculo de frete errado no WooCommerce acontece quando o valor da entrega no checkout vem maior, menor ou diferente do esperado, ou simplesmente não aparece. Quase sempre vem de zonas de entrega mal configuradas, de produtos sem peso e dimensões, ou de classes de frete e regras de frete grátis conflitando entre si.

Setores

Extensões

Integrações

Como corrigir erro de pagamento do Tutor LMS com WooCommerce

O que é o erro de pagamento do Tutor LMS com WooCommerce?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o carrinho do WooCommerce que não funciona com o Elementor Pro

Como corrigir o cupom de desconto que não funciona no WooCommerce

Como corrigir a página de produto do WooCommerce que quebra com o Astra Pro

Como corrigir o estoque do WooCommerce mostrando errado

Como corrigir o produto do WooCommerce com página em branco

Como corrigir o cálculo de frete errado no WooCommerce

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