Entregas e Integrações

Uma entrega é a regra que diz o que o aluno recebe quando compra. Ela liga um produto (ou oferta, ou plano) do seu gateway de pagamento aos cursos da sua plataforma, com o tempo de acesso de cada um e as tags que o aluno ganha.

Toda liberação de acesso por venda passa por uma entrega. Quando o gateway avisa que uma venda foi aprovada, a plataforma procura a entrega que tem aquele ID de produto, cria o aluno (se ele ainda não existir) e libera os cursos. Quando chega um reembolso, chargeback ou cancelamento, os acessos daquela venda são encerrados.

#Como criar uma entrega

1. No painel, abra Vendas › Entregas e clique em Nova Entrega.
2. Na tela Selecione um Gateway, escolha a plataforma por onde você vende. Use o campo de filtro para achar pelo nome. Se você não vende por gateway, escolha Customizado (veja Seu próprio Gateway).
3. No topo da tela, dê um nome à entrega. Escolha um nome que você e sua equipe reconheçam depois, por exemplo Curso X - 12 meses.
4. Preencha os blocos descritos abaixo e clique em Salvar.
5. Depois de salvar, copie a URL de Postback que aparece no bloco Conexão com o gateway e cole no seu gateway.

#Os campos da entrega

#Identificação

• Modalidade de Venda: Venda única ou Assinatura. Na assinatura não existe tempo de acesso: o acesso dura enquanto o gateway disser que a assinatura está ativa e termina quando ele avisar cancelamento ou atraso.
• Tags: tags que o aluno recebe a cada venda aprovada desta entrega. Você pode marcar tags existentes ou criar uma nova no campo Criar tag. Numa entrega já salva, o botão Aplicar tags em todos os alunos aplica as tags marcadas a quem já recebeu acesso por ela.

#Conexão com o gateway

• ID do produto (o nome do campo muda conforme o gateway: Código do Produto, ID do Plano de Venda, ID do Kit de Produtos etc.): o identificador que o gateway dá ao produto, oferta ou plano. Pode colocar mais de um, um por linha. Isso é útil quando várias ofertas devem liberar a mesma coisa, ou quando o gateway manda dois IDs na mesma venda.
• Token (só em alguns gateways): a credencial do gateway. Quando preenchida, a plataforma confere essa credencial em cada venda recebida.
• URL de Postback: o endereço que você cola no gateway. Ela aparece depois que a entrega é salva e tem este formato:

https://<sua-plataforma>/api/postback/<gateway>/<token>

O trecho final é um token exclusivo desta entrega. Cole a URL completa no gateway: sem o token, a venda é recusada (a não ser nos gateways em que você cadastrou o token do próprio gateway).

#Conteúdo entregue

Marque o que a entrega libera:

• Acesso completo a todos os produtos: todos os cursos da plataforma, inclusive os que você criar depois.
• Vitrine inteira: todos os cursos de uma vitrine.
• Um curso específico: marque só a linha dele.

Em cada linha você define:

• Tempo de acesso: deixe em Vitalício ou informe um número de Dias, Meses ou Anos. Na modalidade Assinatura esse campo é ignorado.
• Liberação: uma tag (turma) que o aluno recebe junto com o acesso àquele curso.

Se um curso aparece marcado em mais de um nível (por exemplo, em "todos os produtos" e na própria linha), vale a configuração mais específica, a da linha do curso.

#O que acontece com cada aviso do gateway

Ao encerrar um acesso, a plataforma também tira as tags que aquela venda deu, a menos que o aluno já tivesse a tag antes ou receba a mesma tag por outra venda válida.

O reembolso e o cancelamento atuam sobre a venda com o mesmo código da aprovação. Por isso o gateway precisa mandar o mesmo ID de venda nos dois avisos, o que todos os gateways comuns já fazem.

#E-mails

• Aluno novo recebe o e-mail de boas-vindas da venda.
• Aluno que já existia recebe o e-mail de novo acesso.

#Aluno que já existe

A plataforma procura o aluno primeiro pelo CPF/CNPJ e depois pelo e-mail. Se já existir alguém com aquele documento, a nova compra entra no mesmo perfil, mesmo que o e-mail da venda seja outro. Nome e e-mail do perfil não mudam.

#A tela de Vendas

Tudo o que os gateways enviam aparece em Vendas › Vendas. Para cada venda você vê o gateway, o cliente, o status da venda (Aprovada, Reembolsada, Chargeback, Atrasada…) e o status do processamento:

• Na fila: recebida e esperando para ser processada. Leva poucos segundos.
• Processada: os acessos foram liberados ou removidos.
• Com erro: não deu para processar. Abra a venda (Ver detalhes) para ver o Motivo do erro. Os mais comuns são "Não existe nenhuma entrega configurada para o ID", "Venda sem e-mail válido do cliente" e "Postback sem autorização".
• Ignorada: você mandou ignorar.

Use as abas Últimas, Na Fila, Com erro e Ignoradas para filtrar. Também dá para buscar por e-mail, nome, CPF/CNPJ, ID da venda ou ID da recorrência, e filtrar por gateway.

Na tela de detalhes você vê os IDs de produto que vieram no envio, o histórico de cada aviso recebido com aquele código de venda e os dados brutos (payload) como chegaram.

#Reprocessar e ignorar

• Reprocessar (no menu da venda ou na tela de detalhes): processa a venda de novo. Use depois de corrigir a causa do erro, por exemplo depois de cadastrar o ID que faltava na entrega.
• Reprocessar › Reprocessar → Com erro: reprocessa todas as vendas com erro de uma vez.
• Reprocessar › Forçar reprocessamento: reaplica todas as vendas da plataforma. Acessos já liberados não são duplicados.
• Ignorar: descarta a venda, sem liberar nem remover nada.
• Reprocessar › Lista de produtos ignorados: IDs de produto (um por linha) cujos avisos são descartados sempre. Serve para gateways que mandam todas as vendas da conta, inclusive de produtos que não são entregues pela plataforma.

#Entrega avulsa (sem venda)

Para liberar uma entrega a um aluno manualmente:

1. Abra o perfil do aluno e vá na aba Compras.
2. Clique em Adicionar entrega.
3. Escolha a Entrega (ou só um produto avulso).
4. Se quiser, informe o Início do acesso (pode ser uma data passada) e a data para Encerrar acesso em. Sem data de encerramento, vale o tempo de acesso configurado na entrega.
5. Clique em Adicionar.

A entrega avulsa respeita o tempo de acesso e a liberação de cada curso e aplica as tags da entrega. Ela não envia e-mail: o aluno vê só o aviso de novo acesso dentro da plataforma.

Quem não vende por gateway pode criar entregas do tipo Customizado só para usar dessa forma, com um ID qualquer (por exemplo CURSOX3MESES).

#Outras ações na entrega

• Duplicar: cria uma cópia com os mesmos cursos, tags e configurações, sem os IDs. Informe o ID da cópia e salve.
• Arquivar: novas vendas deixam de usar a entrega. Quem já tem acesso continua com ele. As entregas arquivadas ficam na aba Arquivadas, de onde podem ser restauradas.

#Gateways

Só alguns gateways têm integração dedicada, feita para o formato exato que cada um envia: Kiwify, Hotmart, Xgrow, Herospark e Customizado.

Todos os outros usam leitura automática: a plataforma procura no aviso do gateway os campos comuns (e-mail, nome e CPF do cliente, código da venda, IDs de produto, oferta ou plano, e o status). Funciona para a maioria dos formatos, mas cada gateway tem seus detalhes. Por isso, antes de abrir as vendas, faça uma venda real de teste e confira em Vendas se ela chegou como Processada.

Veja o passo a passo de cada um:

• Abmex
• Appmax
• Asaas
• Assiny
• B4you
• Blitz Pay
• Braip
• Bravvius
• Cakto
• Cartpanda
• Doppus
• Eduzz
• Evermart
• GoHighLevel
• Greenn
• Digital Manager Guru
• Herospark
• Hotmart
• Hubla
• Kavoo
• Kirvano
• Kiwify
• Lastlink
• Lia
• Monetizze
• OnProfit
• PagarMe
• Pagou.ai
• Pagtrust
• Payt
• Perfect Pay
• Shopify
• Stripe
• Tamborete
• Ticto
• Tmb
• Vindi
• Voomp
• Xgrow
• Yampi
• Zouti
• Zuptos
• Seu próprio Gateway (Customizado)

O seu gateway não está nesta lista? Veja se ele aparece na tela Selecione um Gateway: o caminho é o mesmo. Crie a entrega, cole a URL de Postback no gateway, marque os eventos de venda aprovada, reembolso, chargeback e cancelamento, e faça uma venda de teste.