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

  1. In Clakta, go to Project settings → Sales platforms.
  2. 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.
  3. In another tab, open your Kirvano dashboard and go to Integrações → Webhooks → Criar Webhook.
  4. 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 KirvanoWhat happens in Clakta
      Compra aprovadaRecords the sale.
      Assinatura renovadaRecords each renewal as a new sale.
      Compra recusadaRecords the declined purchase attempt.
      ReembolsoMarks the order as refunded.
      ChargebackMarks 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.

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

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