# Entregas e Integrações

> Como ligar as vendas do seu gateway de pagamento aos cursos da sua plataforma.

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](/entregas/custom)).
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).

:::aviso Mesmo ID em duas entregas
Se você cadastrar um ID que já está em outra entrega ativa do mesmo gateway, a plataforma avisa. As duas entregas passam a liberar acesso para a mesma venda.
:::

### 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

| Aviso do gateway | O que a plataforma faz |
|---|---|
| Venda aprovada, paga ou completa | Cria o aluno, se ainda não existir, e libera os cursos da entrega |
| Assinatura renovada ou ativa | Mantém ou renova o acesso |
| Reembolso | Encerra os acessos daquela venda |
| Pedido de reembolso / disputa | Encerra os acessos daquela venda |
| Chargeback | Encerra os acessos daquela venda |
| Venda cancelada | Encerra os acessos daquela venda |
| Assinatura cancelada | Encerra os acessos de todas as cobranças daquela assinatura |
| Assinatura atrasada | Encerra os acessos da assinatura na hora, sem carência |
| Boleto ou Pix gerado, aguardando pagamento | Só registra a venda |
| Pagamento recusado ou expirado | Só registra a venda |
| Troca de plano | Só registra a venda |

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.

:::perigo E-mail de administrador
Uma venda feita com o e-mail de um administrador da plataforma não é processada. Para testar compras, use um e-mail que não seja de administrador.
:::

## 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.

:::dica
Ao criar uma entrega nova, a plataforma já reprocessa sozinha as vendas que estavam com erro.
:::

## 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](/entregas/abmex)
- [Appmax](/entregas/appmax)
- [Asaas](/entregas/asaas)
- [Assiny](/entregas/assiny)
- [B4you](/entregas/b4you)
- [Blitz Pay](/entregas/blitz)
- [Braip](/entregas/braip)
- [Bravvius](/entregas/bravvius)
- [Cakto](/entregas/cakto)
- [Cartpanda](/entregas/cartpanda)
- [Doppus](/entregas/doppus)
- [Eduzz](/entregas/eduzz)
- [Evermart](/entregas/evermart)
- [GoHighLevel](/entregas/gohighlevel)
- [Greenn](/entregas/greenn)
- [Digital Manager Guru](/entregas/guru)
- [Herospark](/entregas/herospark)
- [Hotmart](/entregas/hotmart)
- [Hubla](/entregas/hubla)
- [Kavoo](/entregas/kavoo)
- [Kirvano](/entregas/kirvano)
- [Kiwify](/entregas/kiwify)
- [Lastlink](/entregas/lastlink)
- [Lia](/entregas/lia)
- [Monetizze](/entregas/monetizze)
- [OnProfit](/entregas/onprofit)
- [PagarMe](/entregas/pagarme)
- [Pagou.ai](/entregas/pagou-ai)
- [Pagtrust](/entregas/pagtrust)
- [Payt](/entregas/payt)
- [Perfect Pay](/entregas/perfect-pay)
- [Shopify](/entregas/shopify)
- [Stripe](/entregas/stripe)
- [Tamborete](/entregas/tamborete)
- [Ticto](/entregas/ticto)
- [Tmb](/entregas/tmb)
- [Vindi](/entregas/vindi)
- [Voomp](/entregas/voomp)
- [Xgrow](/entregas/xgrow)
- [Yampi](/entregas/yampi)
- [Zouti](/entregas/zouti)
- [Zuptos](/entregas/zuptos)
- [Seu próprio Gateway (Customizado)](/entregas/custom)

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.