Connect Kirvano
Send your Kirvano sales, renewals, refunds and chargebacks to Clakta over a webhook, and see which ad or channel brought each sale.
Kirvano tells Clakta every time a sale goes through, a subscription renews, or an order is refunded or charged back. That notice is called a webhook. All you have to do is create one in your Kirvano dashboard using two values Clakta generates for you: a URL and a token.
Connect
- In Clakta, go to Project settings → Sales platforms.
- Choose Kirvano, give the connection a name (your store's name works), and click Create connection. Clakta shows the Webhook URL and the Token. Keep this window open.
- In another tab, open your Kirvano dashboard and go to Integrações → Webhooks → Criar Webhook.
- Fill in Kirvano's form:
-
Nome: anything you like, for example "Clakta".
-
URL do Webhook: paste the URL Clakta showed you.
-
Token: paste the token Clakta showed you.
-
Produto: select every product you sell.
-
Evento: tick these five events:
Event in Kirvano What happens in Clakta Compra aprovada Records the sale. Assinatura renovada Records each renewal as a new sale. Compra recusada Records the declined purchase attempt. Reembolso Marks the order as refunded. Chargeback Marks the order as refunded. If you sell subscriptions, don't leave out Assinatura renovada. Without it, Clakta only sees each subscriber's first payment.
Ticking other events does no harm: Clakta receives them and ignores what it doesn't use. That includes PIX gerado and Boleto gerado. A generated Pix or boleto isn't a sale yet. It reaches Clakta when the payment is approved and Kirvano sends Compra aprovada.
-
- Save the webhook in Kirvano. Then go back to Clakta and click Finish.
That's it. From then on, each new sale shows up in Clakta a few seconds after it happens in Kirvano.
Clakta stores the token encrypted and can't show it again. Copy it before you close the window. If you lose it, open the connection in Clakta, click Generate new token, and paste the new value into the webhook in Kirvano. The old token stops working as soon as you generate a new one.
Turn on the Clakta script
To see which ad or channel each sale came from, install the Clakta script on the pages that lead to your Kirvano checkout. When a visitor clicks the checkout link, the script attaches their visit to that link on its own. You don't need to change your links.
Projects in privacy-friendly mode don't send this information, so sales still arrive, but without their source.
If your site builds the checkout link itself
If visitors reach the checkout through a redirect from your server, the script can't see the click. In that case, ask whoever runs your site to add the session to the link:
clakta.decorateKirvanoUrl(url) does the same thing.
Troubleshooting
In Kirvano, open the webhook and click Ver logs to see each delivery and Clakta's response. The most common cases:
Related articles
Connect Shopify
Install the Clakta app on your Shopify store. It sets up checkout tracking, imports your recent orders and matches each sale to the ad that produced it.
Connect Lemon Squeezy
Send your Lemon Squeezy orders, renewals and refunds to Clakta over a webhook, and credit each sale to the visitor who made it.
Connect Dodo Payments
Point Dodo Payments at Clakta with a webhook so your payments, refunds and chargebacks arrive automatically, and each sale is matched to the visitor who made it.