# Hotmart

> Veja como conectar a sua plataforma com a Hotmart.

Com esta integração, cada venda aprovada na Hotmart 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 **Hotmart**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. No campo **ID do Produto**, cole o ID do produto ou o código da oferta na Hotmart. Para achar: no painel da Hotmart, clique em **Produtos › Sou Produtor(a)**. O ID do produto aparece logo abaixo do nome. Para o código da oferta, abra o produto, vá na aba **Precificação e Ofertas** (ou **Cupons**, nos produtos de assinatura) e copie a coluna **Código**. Se mais de um ID deve liberar a mesma coisa, coloque um por linha.
5. No campo **Token**, cole o token da Hotmart. Para achar: em **Ferramentas › Webhook (API e Notificações)**, abra a guia **Autenticação** e clique em **Mostrar Token**. Com o token preenchido, a plataforma confere o token de cada aviso da Hotmart.
6. 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.
7. Clique em **Salvar**.
8. 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.

:::info Produto ou oferta
Quando um aviso traz um ID de produto que está cadastrado numa entrega, ele vale antes do código da oferta. Se você quer dar acessos diferentes por oferta, cadastre só os códigos das ofertas e não use o ID do produto em nenhuma entrega.
:::

## 2. Configure o webhook na Hotmart

1. No painel da Hotmart, clique em **Ferramentas › Webhook (API e Notificações)**.
2. Clique em **Nova Configuração** (botão **+**, no canto superior direito).
3. Em **Nome da Configuração**, coloque um nome que identifique a sua plataforma.
4. Em **Selecione os Produtos**, escolha todos ou só os que serão entregues pela sua plataforma.
5. Em **URL**, cole a URL de Postback da entrega.
6. Em **Versão**, escolha **2.0**.
7. Marque os eventos:
  - Compra cancelada
  - Compra aprovada
  - Compra completa
  - Compra reembolsada
  - Chargeback
  - Pedido de reembolso
  - Compra atrasada
  - Cancelamento de assinatura
  - Troca de plano
8. Clique em **Salvar**.

### Área de membros externa

Se você vai entregar o curso fora da Hotmart, troque a área de membros do produto:

1. Na Hotmart, abra o produto e clique em **Gestão do Curso**.
2. Clique em **Trocar para Área de Membros Externa**.
3. No campo **URL**, informe o endereço da sua plataforma (`https://<sua-plataforma>`).
4. Crie na sua plataforma um aluno para a Hotmart conferir o conteúdo e libere a entrega para ele no perfil do aluno (aba **Compras**, botão **Adicionar entrega**).
5. Na Hotmart, informe o e-mail e a senha desse aluno e clique em **Salvar**.

:::aviso Alunos que já estavam na Hotmart
Ao trocar para a área de membros externa, os alunos perdem o acesso pela área de membros da Hotmart. Importe esses alunos para a sua plataforma ao concluir a troca. A equipe da Hotmart vai entrar com o aluno informado para conferir o curso: se não encontrar o conteúdo, o produto pode ser recusado.
:::

## 3. Teste

1. Na Hotmart, envie os testes do webhook.
2. Os testes da Hotmart trazem dados de exemplo e aparecem **Com erro** em **Vendas**. Isso é esperado. Testes repetidos não duplicam: eles atualizam o mesmo registro.
3. Antes de abrir as vendas, faça uma compra real de teste do produto.
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.