Connect Lovable to Qanary

Time: ~10 minutes. You need: a Qanary program (its slug), your billing provider already connected in Qanary onboarding, and edit access to your Lovable app (chat, or Dev Mode/GitHub sync).

1 · Paste the tracking snippet

<script src="https://app.qanary.cloud/qanary.js" data-qanary="YOUR_PROGRAM_SLUG" async></script>

Ask Lovable’s chat: “Add this script tag to the <head> of index.html.” Or, if you’ve got Dev Mode or GitHub sync switched on, paste it directly into index.html yourself.

The snippet sets the first-party attribution cookie when a visitor lands with ?via=AFFILIATE_CODE (the link format your affiliates already share) and records the touchpoint.

2 · Carry the referral into checkout

Wherever your app kicks off Stripe Checkout (an edge function, a Supabase call, or an API route Lovable built for you), read Qanary.checkoutStamp() client-side and send stamp.ref into client_reference_id.

3 · Verify

Open your app with ?via=<a promoter code> in a private window.
Run a test-mode checkout.
In Qanary: the conversion appears attributed to that promoter — or ask your coding agent to run the MCP diagnose_attribution tool, which walks visit → identify → webhook → attribution → ledger and tells you exactly where anything is off.
Optional: add a webhook endpoint (Webhooks page) and press Send test event to verify your automation receiver too.

Verification checklist (fill in before publishing)

Snippet loads on the deployed app (not just the Lovable preview)
?via= visit recorded (check_events shows the touchpoint)
Test checkout attributes to the right promoter
Recorded by: ______ / date: ______