# Kiwify

> Veja como conectar a sua plataforma com a Kiwify.

Com esta integração, cada venda aprovada na Kiwify 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 **Kiwify**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. No campo **Código do Produto ou Plano**, cole o ID do produto na Kiwify. Para achar: no painel da Kiwify, clique em **Produtos**, clique no nome do produto e copie o ID que aparece no endereço do navegador. Se mais de um ID deve liberar a mesma coisa, coloque um por linha.
5. O campo **Token do webhook (opcional)** pode ficar em branco: a URL de Postback já autoriza as vendas. Se quiser uma conferência extra, cole aqui o token que a Kiwify mostra no webhook (próxima etapa). Com o token preenchido, a plataforma confere a assinatura de cada aviso da Kiwify.
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
A Kiwify manda o ID do **produto principal** em todas as ofertas. Para liberar a mesma coisa em todas as ofertas, basta o ID do produto. Para dar acessos diferentes por oferta, cadastre o ID da **oferta** (ou do checkout) em cada entrega: quando ele vem no aviso, tem prioridade sobre o ID do produto.
:::

## 2. Configure o webhook na Kiwify

1. No painel da Kiwify, clique em **Apps** e depois em **Webhooks**.
2. Clique em **Criar Webhook**.
3. Em **URL do Webhook**, cole a URL de Postback da entrega.
4. Em **Produtos**, selecione todos ou só o produto desta entrega. Se escolher só um, repita esta etapa para os próximos produtos.
5. Marque apenas os eventos:
  - Compra aprovada
  - Reembolso
  - Chargeback
  - Assinatura cancelada
  - Assinatura atrasada
6. Clique em **Salvar**.

## 3. Teste

1. Na Kiwify, clique nos três pontos do webhook criado, em **Editar** e em **Testar webhook**. Escolha um dos eventos e clique em **Enviar**.
2. O teste da Kiwify chega marcado como **teste** em **Vendas** e, como traz dados de exemplo, pode aparecer **Com erro**. Se você preencheu o **Token do webhook** e o teste mostrar "Assinatura da Kiwify não confere", confira se copiou o token certo, ou deixe o campo em branco e use só a URL de Postback.
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.