# Appmax

> Veja como conectar a sua plataforma com a Appmax.

Com esta integração, cada venda aprovada na Appmax libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e cancelamento removem o acesso daquela venda.

## 1. Crie a entrega na sua plataforma

1. No painel, abra **Vendas › Entregas** e clique em **Nova Entrega**.
2. Na tela **Selecione um Gateway**, escolha **Appmax**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. No campo **ID do Kit de Produtos**, cole o ID do kit da Appmax e, na linha de baixo, o ID do produto dentro do kit. Para achar os dois: no painel da Appmax, clique em **Integrações**, localize a integração da sua loja e clique nas reticências (**...**) para copiar o **ID do KIT**. Depois, clique no ícone de edição dessa integração, abra a aba **Produto** e copie o **ID do Produto**. Se mais de um ID deve liberar a mesma coisa, coloque um por linha.
5. Em **Conteúdo entregue**, marque os cursos que a venda libera e defina o **Tempo de acesso** e a **Liberação** de cada um. Se quiser, marque também as **Tags** que o aluno ganha.
6. Clique em **Salvar**.
7. No bloco **Conexão com o gateway**, copie a **URL de Postback**. Ela aparece depois de salvar e termina com o token desta entrega: copie o endereço inteiro.

## 2. Configure o webhook na Appmax

1. No painel da Appmax, clique em **Configurações** e depois em **Apphooks (Webhooks)**.
2. Clique em **Novo Webhook**.
3. Em **Loja**, selecione a loja do seu kit.
4. Em **URL para Envio**, cole a URL de Postback da entrega.
5. Marque apenas estes eventos:
  - Pedido aprovado
  - Pedido autorizado
  - Pedido pago
  - Pedido estornado
  - Upsell pago
  - Assinatura cancelada
  - Assinatura atrasada
6. Clique em **Salvar**.

## 3. Teste

1. Na Appmax, edite o webhook que você acabou de salvar e clique em **Testar Eventos**.
2. Se o envio de teste do gateway aparecer **Com erro**, não se preocupe: o teste costuma trazer dados de exemplo, sem um produto seu. O importante é que ele chegou. A confirmação de verdade é uma compra real.
3. Antes de abrir as vendas, faça uma compra real de teste do kit.
4. No painel, abra **Vendas › Vendas** e confira se o envio chegou.
5. Se estiver como **Processada**, o acesso foi liberado. Se estiver **Com erro**, clique em **Ver detalhes** e leia o **Motivo do erro**. Corrija a causa (por exemplo, cadastrando na entrega o ID que veio no envio) e clique em **Reprocessar**.

Para a compra de teste, use um e-mail que não seja de um administrador da plataforma: vendas com e-mail de administrador não são processadas.

:::info Integração por leitura automática
A Appmax não tem integração dedicada: a plataforma lê o aviso enviado e reconhece sozinha os campos comuns, como e-mail, nome e CPF do cliente, código da venda, IDs de produto ou oferta e o status. Como cada gateway tem seus detalhes, valide com uma venda real antes de abrir as vendas. Se algum dado não for reconhecido, a venda aparece em **Vendas › Vendas** como **Com erro**, com o motivo, e os dados brutos ficam em **Ver detalhes**.
:::
