Pular para o conteúdo

Kiwify

Veja como conectar a sua plataforma com a Kiwify.

Nesta página

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

Esta página ajudou?

Artigos relacionados