Connect Kiwify

Send your Kiwify sales, renewals, refunds and chargebacks to Clakta over a webhook, and credit each sale to the visitor who made it.

Kiwify sends your sales, renewals, refunds and chargebacks to Clakta through one webhook, set up in three steps.

Connect

1. In Clakta: create the connection

Go to Project settings → Sales platforms, choose Kiwify, give the connection a name, and click Create connection. Clakta generates a webhook URL. Copy it.

2. In Kiwify: create the webhook

Go to Apps → Webhooks → Criar Webhook, then:

  • Paste the URL from Clakta.
  • Select all your products.
  • Enable the five triggers listed below.
  • Save.

3. Back in Clakta: paste the token

Kiwify shows a token for the webhook. Copy it, paste it into Clakta, and click Finish.

The card reads Added once the token is saved.

Kiwify has a Testar Webhook button next to the saved webhook. Use it to confirm the connection works before your next real sale.

Triggers to enable

Trigger (in Kiwify)What it does in Clakta
Compra aprovadaRecords the sale.
Assinatura renovadaRecords each renewal as its own sale.
Compra recusadaRecords a declined purchase.
Compra reembolsadaMarks the order refunded.
ChargebackMarks the order refunded.

Extra triggers are harmless: anything Clakta does not handle is acknowledged and ignored. But leave Assinatura renovada out and you only ever see the first payment of a subscription, because a renewal never fires Compra aprovada.

Turn on the Clakta script

To credit each sale to the visit that brought it, install the Clakta script on the pages that link to your Kiwify checkout. The script adds the visitor's session to the checkout on its own, so there is nothing else to set up. Projects in privacy-friendly mode don't send this session.

If you build the checkout in your own code

For a checkout the script can't see, such as a server-side redirect, decorate the URL yourself:

If your checkout runs on a domain of your own, add sck yourself with clakta.getSessionId().

Troubleshooting

Related articles