Pular para o conteúdo

Kirvano

Veja como conectar a sua plataforma com a Kirvano.

Nesta página

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.
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.
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.

Esta página ajudou?

Artigos relacionados