# Kirvano

> Veja como conectar a sua plataforma com a Kirvano.

Com a integração da Kirvano, cada venda aprovada (ou assinatura renovada) libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback, assinatura cancelada ou atrasada removem o acesso.

## 1. Crie a entrega na sua plataforma

1. No painel, acesse **Vendas › Entregas** e clique em **Nova Entrega**.
2. Na tela **Selecione um Gateway**, digite "Kirvano" no filtro e clique em **Kirvano**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. Em **Conexão com o gateway**, cole no campo **ID do Produto** o ID do produto na Kirvano (veja abaixo). Um ID por linha.
5. Em **Conteúdo entregue**, marque os cursos ou vitrines que a venda libera e, se quiser, o **Tempo de acesso** e a turma em **Liberação**. Em **Tags**, marque as tags que o aluno deve receber.
6. Clique em **Salvar**.
7. Copie o endereço completo do campo **URL de Postback**, no formato `https://<sua-plataforma>/api/postback/kirvano/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o ID do produto na Kirvano

1. No painel da Kirvano, clique em **Produtos** no menu lateral.
2. Clique no nome do produto.
3. Copie o ID que aparece na barra de endereços do navegador.

## 2. Configure o webhook na Kirvano

1. No painel da Kirvano, clique em **Extensões** e depois em **Webhook**.
2. Clique em **Criar Webhook**.
3. Em **URL do Webhook**, cole a URL de postback da entrega.
4. Se a Kirvano pedir um **Token**, pode preencher qualquer valor: quem autoriza a venda na sua plataforma é o token que já está no fim da URL.
5. Selecione os eventos:
   - Compra aprovada
   - Reembolso
   - Assinatura cancelada
   - Assinatura atrasada
   - Assinatura renovada
6. Clique em **Salvar**.

:::aviso Uma URL para cada entrega
A URL de postback leva o token de **uma** entrega e só libera o conteúdo dela. Se o webhook mandar vendas de outros produtos para esse endereço, elas aparecem com erro em **Vendas › Vendas** (você pode usar **Ignorar** nelas). Se vários produtos liberam o mesmo conteúdo, coloque todos os IDs na mesma entrega.
:::

## 3. Teste

1. Use o teste de integração da Kirvano. O teste traz dados fictícios, sem produto real, então ele costuma aparecer em **Vendas › Vendas** na aba **Com erro**. Se apareceu, a URL está certa.
2. Depois, faça uma compra real com um e-mail que **não** seja de administrador da plataforma.
3. Abra a venda em **Vendas › Vendas** (menu **···** › **Ver detalhes**) e confira o evento recebido, os **IDs de produto/oferta no payload** e, se houver, o **Motivo do erro**.
4. Corrigiu a entrega? Clique em **Reprocessar** na venda.

:::info Integração por leitura automática
A plataforma reconhece os campos mais comuns do envio da Kirvano (e-mail, código da venda, status e IDs do produto). Valide com uma venda real antes de abrir as vendas. Se algo não for reconhecido, a venda aparece em **Vendas › Vendas**, na aba **Com erro**, com o motivo.
:::