Conectar a Curseduca
Coloque o comprador nos grupos de acesso (turmas) da Curseduca quando a venda for aprovada e tire o acesso em reembolso, chargeback ou cancelamento, sem apagar o aluno.
Com a Curseduca conectada, cada venda aprovada coloca o comprador nos grupos de acesso (turmas) que você escolheu para aquela oferta. Quem compra pela primeira vez recebe o e-mail de cadastro da Curseduca para criar a senha. Quando a compra é reembolsada, sofre chargeback ou a assinatura é cancelada ou expira, o aluno sai desses grupos e continua cadastrado, com o progresso guardado.
Antes de começar, vale ler como funcionam as áreas de membros.
Antes de começar
- Uma escola na Curseduca com os grupos de acesso (turmas) já criados.
- A API Key e o token de acesso da API da Curseduca.
- Papel Admin ou Dono no projeto do Vipter.
- Um produto com ao menos uma oferta criada no Vipter.
Passo 1: conseguir as credenciais e os IDs dos grupos
A integração usa duas credenciais da API da Curseduca: a API Key e o token de acesso. Procure as duas na área de integrações ou de API do seu painel. Se não encontrar, peça ao suporte da Curseduca a API Key e o token de acesso da API da sua escola.
Anote também o ID numérico de cada grupo de acesso que as ofertas vão liberar. Se o painel não mostrar o ID, peça ao suporte junto com as credenciais.
Guarde as credenciais com cuidado
Com as duas credenciais dá para criar alunos e mudar os acessos da sua escola. Cole só no Vipter. Depois de salvas, os campos mostram só o final delas.
Passo 2: conectar no Vipter
- No painel do Vipter, abra GeralIntegraçõesÁreas de membrosCurseduca.
- Em Conexão, preencha os campos e deixe ligado Ativo — enviar acessos para esta plataforma.

| # | Campo | O que colar |
|---|---|---|
| 1 | Chave de API | A API Key da Curseduca. |
| 2 | Token de acesso | O token de acesso da API da Curseduca. |
- Clique em Salvar e depois em Testar conexão. O Vipter consulta os grupos da escola com as duas credenciais.
Passo 3: ligar cada oferta aos grupos
O Vipter só libera acesso das ofertas que têm uma regra. Sem regra, nada é enviado para a Curseduca.
- Em Regras de acesso, escolha a Oferta.
- Informe os IDs dos grupos de acesso (turmas) separados por vírgula, como
12, 34. - Clique em Adicionar regra. Repita para cada oferta que dá acesso.
Passo 4: testar com uma compra
Faça uma compra de teste de uma oferta que tem regra, com um e-mail que você consegue abrir.
Confira a primeira compra com atenção
A integração com a Curseduca é nova e ainda não foi conferida numa escola de verdade. Depois da primeira compra de teste, confira na Curseduca se o aluno entrou nos grupos certos e se o e-mail de cadastro chegou, antes de divulgar a oferta.
Deu certo se
A compra aparece em Envios recentes como Acesso liberado, com o status succeeded, e o aluno aparece nos grupos dentro da Curseduca.
Como funciona depois
- Venda aprovada: o Vipter procura o aluno pelo e-mail. Um aluno novo é criado já dentro de todos os grupos da regra e recebe o e-mail de cadastro da Curseduca. Um aluno que já existe entra nos grupos em que ainda não está.
- Aluno inativo: quem estava inativo na Curseduca é reativado antes de entrar nos grupos. Um aluno bloqueado continua bloqueado: essa decisão é sua.
- Reembolso, chargeback, assinatura cancelada ou expirada: o aluno sai dos grupos da regra. O cadastro e o progresso dele continuam na Curseduca.
- Dados enviados: nome, e-mail, CPF ou CNPJ e, para números brasileiros, o celular.
Novas tentativas e reenvio
Se a Curseduca não responder ou der um erro passageiro, o Vipter tenta de novo sozinho em 5 minutos, 30 minutos, 2 horas, 6 horas e 24 horas. Uma recusa definitiva, como credenciais erradas, um grupo que não existe ou um ID que não é número, não é repetida. Depois de corrigir, use Reenviar na linha do envio. Veja novas tentativas e reenvio.
Problemas comuns
-
A plataforma rejeitou as credenciais
Uma das credenciais está errada ou não vale mais. Copie as duas de novo. Para trocar só uma, preencha esse campo e deixe o outro em branco.
-
O envio falhou com "group ids must be numbers"
A regra tem algo que não é um ID numérico, como o nome da turma. Remova a regra e crie outra com os IDs. Depois, libere o acesso desse comprador direto na Curseduca: o reenvio repete a regra antiga.
-
O envio falhou em "group 12" com 404
O grupo 12 não existe na escola. Confira os IDs com a Curseduca.
O que fazer a seguir
- Entenda como funcionam as áreas de membros.
- Para avisar o aluno por e-mail, conecte um provedor de e-mail.
Conectar o Membox
Cadastre o comprador no Membox quando a venda for aprovada e remova o acesso em reembolso, chargeback ou cancelamento.
Conectar a The Members
Libere os produtos da The Members ao comprador quando a venda for aprovada e desative a assinatura dele em reembolso, chargeback ou cancelamento.