A sale went through, your partner swears they referred it, but Traaaction shows nothing. Here's the short list — checked in order of likelihood.
1. The Stripe webhook didn't fire
Open Stripe → Developers → Webhooks → [your Traaaction endpoint] → Logs. If the event isn't there:
- The webhook isn't configured. See Stripe webhook setup.
- The event type isn't subscribed. Verify all four are selected:
checkout.session.completed,invoice.paid,charge.refunded,customer.subscription.deleted.
2. The webhook fired but returned an error
Still in Stripe's webhook logs — is the response 4xx or 5xx?
401→ signing secret mismatch. Regenerate in Traaaction (Dashboard → Developer → Webhooks) and paste into Stripe.404→ endpoint URL is wrong. Copy it again.5xx→ check Dashboard → Developer → Webhooks → Logs in Traaaction for the exact failure reason.
3. tracClickId is missing from metadata
This is the #1 real-world cause. Open the Stripe event payload and look for data.object.metadata.tracClickId. If it's missing or null:
- Your Checkout creation code isn't reading the cookie. See the SDKs guide — both the TS and Python SDKs ship
getClickId(request). - The user came through a session that didn't hit your site's tracking (e.g. they clicked a Payment Link directly). For Payment Links, append
?trac_click_id=...to the URL.
4. The click ID was never set
If the user never clicked a Traaaction tracked link, there's no cookie. This is correct behavior — Traaaction only attributes clicks that went through our redirect.
Verify in the browser: open the customer's own browser devtools → Application → Cookies → look for trac_click_id. If it's missing, the user didn't come through a tracked link.
5. The gross amount is zero or negative
Traaaction skips commissions when grossAmount <= 0:
- 100% discount coupons
- Trial sign-ups (no charge yet)
- Credit-funded purchases
The webhook log will show the event as "skipped — zero amount". Not a bug; working as designed.
6. The partner's enrollment isn't active
If the link was created under a seller whose enrollment is PENDING or BANNED, the commission won't be created. Check Dashboard → Sellers → [seller] and make sure the status is APPROVED.
Still stuck?
- Check that the mission is
ACTIVE(notDRAFTorARCHIVED). - Verify the mission matches the plan being purchased — if you have one mission per product and the customer bought a product the mission doesn't cover, no commission triggers.
- Contact support with the Stripe
event_idand we'll trace it end-to-end.
Related
- How tracking works — the full click-to-commission flow
- Stripe webhook setup — the 4 required events
- Commission lifecycle — what happens once the commission is created