Conectar Kiwify

Envie vendas, renovações, reembolsos e chargebacks da Kiwify para o Clakta por webhook e credite cada venda ao visitante que a gerou.

A Kiwify envia suas vendas, renovações, reembolsos e chargebacks ao Clakta por um webhook, configurado em três passos.

Conectar

1. No Clakta: crie a conexão

Vá em Configurações do projeto → Plataformas de vendas, escolha Kiwify, dê um nome à conexão e clique em Criar conexão. O Clakta gera uma URL de webhook. Copie.

2. Na Kiwify: crie o webhook

Vá em Apps → Webhooks → Criar Webhook e:

  • Cole a URL do Clakta.
  • Selecione todos os seus produtos.
  • Habilite os cinco gatilhos listados abaixo.
  • Salve.

3. De volta ao Clakta: cole o token

A Kiwify mostra um token para o webhook. Copie, cole no Clakta e clique em Concluir.

O card mostra Adicionada assim que o token é salvo.

A Kiwify tem um botão Testar Webhook ao lado do webhook salvo. Use para confirmar que a conexão funciona antes da sua próxima venda real.

Gatilhos a habilitar

Gatilho (na Kiwify)O que faz no Clakta
Compra aprovadaRegistra a venda.
Assinatura renovadaRegistra cada renovação como uma venda própria.
Compra recusadaRegistra uma compra recusada.
Compra reembolsadaMarca o pedido como reembolsado.
ChargebackMarca o pedido como reembolsado.

Gatilhos extras são inofensivos: tudo o que o Clakta não trata é confirmado e ignorado. Mas se você deixar Assinatura renovada de fora, só vai ver o primeiro pagamento de cada assinatura, porque uma renovação nunca dispara Compra aprovada.

Ative o script do Clakta

Para creditar cada venda à visita que a trouxe, instale o script do Clakta nas páginas que levam ao checkout da Kiwify. O script adiciona a sessão do visitante ao checkout sozinho, então não há mais nada para configurar. Projetos com modo privacidade não enviam essa sessão.

Se você monta o checkout no seu próprio código

Para um checkout que o script não vê, como um redirecionamento pelo servidor, decore a URL você mesmo:

Se o seu checkout roda num domínio seu, adicione o sck você mesmo com clakta.getSessionId().

Solução de problemas

Artigos relacionados