Enrollment Tutor LMS: aluno não consegue comprar curso

Tipo Outros erros

Nome do erro Erro de enrollment no Tutor LMS EN: Tutor LMS enrollment error

Severidade Crítico

Descrição O erro de enrollment no Tutor LMS acontece quando o aluno tenta comprar um curso pago e a matrícula não é concluída: o botão de compra não aparece ou o pagamento passa mas o acesso nunca é liberado. Costuma vir do produto WooCommerce não vinculado ao curso, do curso marcado como Gratuito ou do pedido que não chega a Concluído.

O que é o erro de enrollment no Tutor LMS?

O enrollment é a matrícula do aluno em um curso do Tutor LMS, ou seja, o registro que concede acesso ao conteúdo. Em cursos pagos, essa matrícula é disparada automaticamente quando uma compra é concluída pelo motor de monetização configurado (WooCommerce, eCommerce nativo, Easy Digital Downloads ou Paid Memberships Pro). O erro de enrollment no Tutor LMS é quando esse fluxo quebra: o aluno paga mas não é matriculado, ou nem consegue iniciar a compra porque o curso não está corretamente ligado a um produto vendável.

Como identificar

O aluno clica em ‘Comprar agora’ ou ‘Adicionar ao carrinho’ e nada acontece, ou o botão de compra simplesmente não aparece na página do curso.
O pagamento é aprovado no WooCommerce, mas o aluno continua vendo ‘Matricular-se’ / ‘Enroll Now’ e não acessa as aulas.
O painel do aluno mostra o curso como ‘Não matriculado’, mesmo com o pedido pago na lista de pedidos.
Na lista de pedidos do WooCommerce o pedido fica preso em ‘Pendente’ ou ‘Processando’ e nunca chega a ‘Concluído’, deixando a matrícula sem ser disparada.
Mensagem ‘Você precisa adquirir este curso para acessá-lo’ aparece para um aluno que já pagou.

Antes de começar: Faça backup do banco antes de rodar qualquer SQL ou snippet de matrícula manual, e teste em ambiente de staging. Forçar matrícula direto no banco sem o pedido correspondente pode liberar acesso sem pagamento.

Como prevenir

Mantenha apenas um motor de eCommerce ativo no Tutor LMS e não troque de motor com cursos já vendidos sem migrar os vínculos
Padronize o produto do curso como Simples, Virtual e ‘For Tutor’ habilitado, e configure o WooCommerce para concluir automaticamente pedidos virtuais
Após criar um curso pago, faça uma compra de teste com um aluno real até ver a matrícula liberada antes de divulgar a turma

Causa

O produto WooCommerce não está vinculado ao curso na seção 'Add Product' do editor do curso, então a compra não tem como conceder a matrícula.
O tipo do curso ficou como 'Gratuito' (Free) em vez de 'Pago' (Paid), fazendo o Tutor LMS ignorar o produto e não exibir o botão de compra.
Mais de um motor de eCommerce ativo ao mesmo tempo: o Tutor LMS aceita apenas um motor por vez em Settings -> Monetization -> Select eCommerce Engine, e o conflito quebra a matrícula.
O pedido do WooCommerce não atinge o status 'Concluído' (fica em 'Processando' ou 'Pendente'), e a matrícula do Tutor LMS só dispara quando o pedido é marcado como Concluído.
O produto WooCommerce está sem a opção 'For Tutor' marcada ou não é do tipo Simples/Virtual, então o gancho de matrícula do Tutor LMS não reconhece a compra.
Guest Checkout ligado sem criação de conta: a compra é feita sem usuário associado, e a matrícula não encontra um aluno para vincular.

Como resolver

Confirme o motor de monetização: abra as configurações do Tutor LMS e garanta que existe apenas um motor de eCommerce ativo, pois mais de um em paralelo quebra a matrícula. Para vender via WooCommerce, selecione WooCommerce nesta tela.
```
WP Admin -> Tutor LMS -> Settings -> Monetization -> Select eCommerce Engine = WooCommerce
```
Crie o produto WooCommerce correto: o produto que representa o curso precisa ser do tipo Simples, marcado como Virtual e com a opção 'For Tutor' habilitada, senão o gancho de matrícula não reconhece a venda. Defina o preço regular nele.
```
WP Admin -> Produtos -> Adicionar novo
Tipo de produto: Produto simples | Virtual: ativado | For Tutor: ativado
```
Vincule o produto e marque o curso como Pago: no editor do curso, vá até a seção 'Add Product', troque o tipo do curso de Gratuito para Pago e selecione o produto WooCommerce no campo de seleção. Salve com Atualizar para gravar o vínculo.
```
Editar o curso -> seção 'Add Product' -> Course Type: Paid -> selecionar o produto WooCommerce
Clicar em Atualizar/Publicar
```
Habilite um meio de pagamento: sem gateway ativo nenhuma transação é processada, então a compra falha antes de gerar pedido. Ative pelo menos um meio de pagamento no WooCommerce e teste uma compra real.
```
WP Admin -> WooCommerce -> Configurações -> Pagamentos -> ativar o gateway desejado
```
Garanta que o pedido chega a Concluído: a matrícula do Tutor LMS dispara quando o pedido fica Concluído. Para produtos virtuais, deixe o WooCommerce concluir automaticamente pedidos virtuais ou marque o pedido pago manualmente como Concluído para liberar o acesso.
```
WP Admin -> WooCommerce -> Pedidos -> abrir o pedido -> Status: Concluído
```

PHP

add_action( 'init', function () {
    if ( ! is_admin() || ! current_user_can( 'manage_options' ) ) {
        return;
    }
    // Ajuste os IDs reais: curso e aluno que pagou mas ficou sem matricula.
    $course_id  = 123;
    $student_id = 456;

    if ( function_exists( 'tutor_utils' )
        && ! tutor_utils()->is_enrolled( $course_id, $student_id ) ) {
        add_filter( 'tutor_enroll_data', function ( $data ) {
            $data['post_status'] = 'completed';
            return $data;
        } );
        tutor_utils()->do_enroll( $course_id, 0, $student_id );
    }
} );

Perguntas frequentes

O aluno pagou mas continua aparecendo 'Matricular-se'. O que houve?

Quase sempre o pedido do WooCommerce não chegou ao status Concluído, que é o gatilho da matrícula no Tutor LMS. Abra o pedido em WooCommerce, Pedidos, e marque como Concluído. Como prevenção, ative a conclusão automática de pedidos virtuais.

Por que o botão de comprar não aparece na página do curso?

O curso provavelmente está com o tipo definido como Gratuito ou sem produto vinculado. No editor do curso, na seção Add Product, troque para Pago e selecione o produto WooCommerce correspondente, depois salve.

Posso usar WooCommerce e Easy Digital Downloads juntos no Tutor LMS?

Não. O Tutor LMS aceita apenas um motor de eCommerce ativo por vez em Settings, Monetization, Select eCommerce Engine. Manter dois ligados quebra o fluxo de matrícula. Escolha um e desative o outro.

Criei o produto mas a matrícula não dispara. O que verificar?

Confirme que o produto é do tipo Simples, está marcado como Virtual e tem a opção For Tutor habilitada. Sem isso, o gancho do Tutor LMS não associa a compra ao curso e a matrícula não acontece.

O Guest Checkout pode atrapalhar a matrícula?

Sim. Se a compra é finalizada sem criar conta, não existe usuário para vincular ao curso. Garanta que o checkout crie a conta do aluno, ou exija login antes da compra, para que a matrícula tenha a quem ser atribuída.

A versão gratuita do Tutor LMS vende cursos com WooCommerce?

Sim, mas o produto precisa ser criado e vinculado manualmente. A geração automática do produto a partir do curso é recurso do Tutor LMS Pro. No gratuito, crie o produto e ligue-o ao curso na seção Add Product.

Como libero o acesso de um aluno que pagou e ficou sem matrícula?

Depois de confirmar o pedido pago, marque-o como Concluído para o Tutor LMS matricular automaticamente. Se ainda assim não liberar, use a função oficial de matrícula do plugin via snippet para enturmar o aluno, sempre com backup antes.

Grave

Como corrigir a integração com Zoom nas aulas ao vivo do Tutor LMS no WordPress

A integração do Tutor LMS com o Zoom falha quando as credenciais ainda são do antigo app JWT (descontinuado), quando o app Server-to-Server OAuth está sem os escopos de Meeting, ou quando o addon Zoom Integration do Tutor LMS Pro não está ativo. A reunião não é criada e o botão da aula ao vivo não aparece.

Atenção

Como corrigir a integração com Zoho/Salesforce no WPForms

A integração Zoho/Salesforce no WPForms falha quando o addon exige a licença Elite, o site não roda em HTTPS, o app conectado (Connected App) do CRM está mal configurado ou o mapeamento de campos do formulário não casa com os campos do objeto no CRM, fazendo o envio não criar o registro.

Grave

Como corrigir o formulário multi-página que não avanca no WPForms

Quando o WPForms multi-page não avanca, o visitante clica em Next e o formulário fica parado na mesma página. As duas causas reais são um campo obrigatório não preenchido na página atual ou o JavaScript do WPForms quebrado por cache ou minificacao.

Grave

Como corrigir instrutores sem permissão para criar cursos no Tutor LMS

A falta de permissão de instrutor no Tutor LMS faz o usuário abrir o painel sem o botão Create a New Course ou receber acesso negado ao salvar. A causa quase sempre é o Marketplace desligado, a conta de instrutor ainda Pending ou a role tutor_instructor não aplicada ao usuário.

Grave

Como corrigir o erro de reCAPTCHA no WPForms

Quando o reCAPTCHA do WPForms não funciona, o formulário trava ao enviar, mostra 'Error for site owner: Invalid site key' ou o desafio nem aparece. As causas mais comuns são Site Key e Secret Key trocadas, o tipo de chave (v2 ou v3) diferente do escolhido em WPForms, e o domínio ausente no painel do Google reCAPTCHA.

Atenção

Como corrigir o mapa do Google que não aparece no WordPress

O mapa do Google que não aparece no WordPress quase sempre indica uma chave de API ausente, restrita demais ou sem faturamento ativo na conta. O resultado é um bloco cinza, um mapa com a marca d'água 'For development purposes only' ou um erro no console; a correção é gerar e restringir corretamente a chave da Google Maps Platform.

Setores

Extensões

Integrações

Erro de enrollment no Tutor LMS: aluno não consegue comprar o curso

O que é o erro de enrollment no Tutor LMS?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir a integração com Zoom nas aulas ao vivo do Tutor LMS no WordPress

Como corrigir a integração com Zoho/Salesforce no WPForms

Como corrigir o formulário multi-página que não avanca no WPForms

Como corrigir instrutores sem permissão para criar cursos no Tutor LMS

Como corrigir o erro de reCAPTCHA no WPForms

Como corrigir o mapa do Google que não aparece 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