Troubleshooting

Common problems and fixes for SDK and Stripe integration.

Quick Checks

console.log('SDK loaded:', !!window.Geddle)
console.log('Track ID:', window.Geddle?.getReferral())

Check Partner Dashboard → SDK Integration for "SDK Script: Detected"

Check Stripe Dashboard → Subscriptions → Metadata for geddle_referral key

---

SDK Not Detected

Script tag missing: View page source and search for src="https://geddle.com/sdk/latest.js". If missing, add it to your HTML.

Script blocked: Disable ad blockers, check browser console for network errors, verify geddle.com isn't blacklisted.

Wrong environment: SDK verification checks your production site, not localhost.

Script not loading: Check DevTools → Network tab → Filter "JS" → Look for latest.js with status 200.

---

No Tracking Data

Product must be published and affiliate must have clicked a referral link. The "Tracking Data: Receiving data" indicator only appears after real affiliate clicks.

Invalid referral code: Affiliate must join your program before their code works. Check Partner Dashboard → Programs → Affiliates.

Blocked requests: Check DevTools → Network tab for tracking requests. 400 error = invalid code, 403/404 = affiliate hasn't joined.

---

Cookie Not Set

Privacy settings: Test in incognito. SDK automatically falls back to localStorage if cookies blocked. Check: localStorage.getItem('geddle_referral')

Invalid code: SDK only sets cookie if referral code validates. Check Network tab for validation response.

Wrong domain: Cookie should be on root domain (.yoursite.com). Check DevTools → Application → Cookies.

---

Track ID is Null

Users who don't click affiliate links won't have a track ID. This is normal.

Cookie expired: Default is 60 days. User may have cleared cookies.

SDK not loaded: Check window.Geddle exists before calling getReferral().

---

Stripe Metadata Missing

Track ID not sent to server: Add logging to verify client sends track ID:

const trackId = window.Geddle?.getReferral()
console.log('Sending track_id:', trackId)

Server not receiving: Log on server to verify it receives track ID from request body.

Wrong metadata key: Must be exactly geddle_referral, not track_id or anything else.

---

Commission Not Attributed

Missing metadata: Check Stripe subscription metadata for geddle_referral with UUID value.

Webhook not delivered: Stripe Dashboard → Developers → Webhooks → Check invoice.paid events delivered successfully.

Mismatched IDs: Cookie value, Stripe metadata, and affiliate dashboard should all show same UUID.

Affiliate joined after click: Affiliate must join program before user clicks link.

Processing delay: Webhooks can take 1-5 minutes. Wait and refresh.

---

Test Cards Not Working

Stripe test mode cards:

• Success: 4242 4242 4242 4242
• Decline: 4000 0000 0000 0002

Any future expiry and any CVC works with test cards.

---

Still Having Issues?

Contact partner@geddle.com with your product ID, issue description, and screenshots of console errors or Stripe metadata.