For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/features/integrations/kirvano.md.
  • English

      • Integrate Kirvano

      Create the integration in Clickmax, copy the generated integration URL and Token, then register a webhook in Kirvano with both values. From then on every Kirvano purchase, Pix, boleto, refund, abandoned cart or subscription change becomes a contact and an activity in Clickmax.

      Role required: only Owner and Admin manage integrations. Plan required:

      Before you start: have access to your Kirvano account, under Integrations > Webhooks.

      Step by step

      The Token for this integration is generated by Clickmax — unlike other platforms, there is no token to fetch from Kirvano beforehand.

      1. In Clickmax, open Integrations and pick Kirvano.
      2. Fill in Name with a nickname and click Create integration.
      3. Copy the integration URL and the Token shown by Clickmax.
      4. In Kirvano, go to Integrations > Webhooks and click Create Webhook.
      5. Paste the URL into Webhook URL and the Token into Token.
      6. Pick the products and the events that should fire the webhook.
      7. Save the webhook in Kirvano and click Complete integration in Clickmax.

      The Token is what guarantees only your Kirvano account can send data to that URL. Without it filled in on the Kirvano side, deliveries are rejected.

      Events received

      Every event creates or updates a contact tagged kirvano and records an activity in its history. An approved purchase of a one-time product is recorded as a purchase; of a recurring product, as a new subscription.

      Event in KirvanoWhat happens in ClickmaxRecords a sale
      Purchase approved (one-time)Purchase approved; the contact becomes a customerYes
      Purchase approved (subscription)Subscription created; the contact becomes a customerYes
      Subscription renewedSubscription renewedYes
      Purchase refusedPurchase refusedYes
      RefundRefundYes
      ChargebackChargebackYes
      Abandoned cartAbandoned cartNo
      Pix generated / Pix expiredCharge awaiting payment / expiredNo
      Boleto generated / Boleto expiredCharge awaiting payment / expiredNo
      Subscription canceledSubscription canceledNo
      Subscription past dueRenewal not paidNo

      Events that record a sale transition the same sale as its status changes (approved → refunded, for example) instead of creating a new one. Every product in the order is taken into account, order bumps included.

      All of these events are also available as automation triggers — see the trigger reference.

      If it didn't work

      • The contact doesn't show up: events without the buyer's email are ignored. Check that your Kirvano checkout captures email; see the error codes.
      • Kirvano reports a delivery error: make sure the Token field on the Kirvano webhook holds exactly the value Clickmax generated, with no extra spaces, and that the whole URL was pasted.
      • Contacts arrive but no sales: check which events you selected on the Kirvano webhook. Pix/boleto generated, abandoned cart and subscription changes are activity-only by design.
      • The automation doesn't fire: the trigger needs an active integration receiving the webhooks. Also check that the product picked in the trigger matches the one in the order — leave it empty to fire for any product.