# Eduzz

> Veja como conectar a sua plataforma com a Eduzz.

Com esta integração, cada venda aprovada na Eduzz 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 **Eduzz**.
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 na Eduzz. Para achar: no painel da Eduzz, clique em **Produtos** e no botão de reticências (**...**) do produto. O ID aparece no título da janela que se abre. 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.

:::aviso Produtos com variações
Quando um produto da Eduzz tem variações, as vendas deixam de usar o ID principal. Nesse caso, cadastre o **ID de cada variação** (uma entrega por variação, se cada uma libera coisas diferentes).
:::

## 2. Configure o webhook na Eduzz

1. No painel da Eduzz, abra o **Developer Hub** em **Webhook › Configurações**.
2. Clique em **Nova configuração**.
3. Em **Nome da configuração**, coloque um nome que identifique a sua plataforma.
4. Em **Secret (chave de acesso)**, mantenha o padrão.
5. Em **URL para envio dos dados**, cole a URL de Postback da entrega.
6. Em **Máximo de eventos enviados em paralelo**, pode deixar **10**.
7. Em **Quais eventos você deseja receber?**, escolha **My Eduzz** e marque:
  - Chargeback de Faturas
  - Comissões processadas
  - Contrato atualizado
  - Contrato criado
  - Fatura agendada
  - Fatura aguardando pagamento
  - Fatura aguardando reembolso
  - Fatura cancelada
  - Fatura criada
  - Fatura em negociação
  - Fatura em recuperação
  - Fatura expirada
  - Fatura paga
  - Fatura reembolsada
8. Clique em **Criar configuração**.

## 3. Teste

1. Na Eduzz, clique em **Testar eventos selecionados**. A resposta precisa ser **200**.
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. Testes repetidos não duplicam: eles atualizam o mesmo registro, e a data de atualização aparece abaixo da data da venda.
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.

:::info Integração por leitura automática
A Eduzz 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**.
:::