Affiliate Postback URL: Wat Doet Het Voor Creators

Een affiliate creator uit Ankara wilde dat haar Discord-kanaal direct een melding kreeg zodra een nieuwe commission binnenkwam tijdens haar live coaching-sessie. De oplossing kwam met de postback URL uit Phase 3.

Hoe het werkt

Open in het affiliate dashboard Settings → Postback URL. Plak je endpoint, zet de toggle aan en klik op Generate Signing Secret. De secret is een 32-karakter hex-string die maar één keer wordt getoond; daarna leeft hij alleen als hash in de DB.

Bij elk event — created, refunded of released — POST de worker naar je URL met header X-thMenu-Signature: sha256=<hmac>. Je herberekent de HMAC server-side en vergelijkt constant-time.

Echte scenario's

Het krachtigste patroon voor creators is Discord webhook-integratie. De Ankara-creator zond live naar haar 320 coaching-leden: "Iemand heeft net mijn code gebruikt — 47 USD commission". De engagement verdrievoudigde binnen een uur.

Andere bestemmingen: Slack-bots, persoonlijke HubSpot of Notion CRM's, Zapier/Make flows naar Google Sheets, Telegram push, en e-mailsamenvattingen voor een boekhouder. Elk event-type kan anders worden verwerkt.

Betrouwbaarheid

Als je endpoint binnen 5 seconden geen 2xx geeft, schrijft de worker een fout naar affiliate_postback_log. Elk uur probeert een retry-cron opnieuw — tot 5 pogingen met exponentiële backoff (1m, 5m, 30m, 2u, 6u). Na de vijfde mislukking wordt het event als dood gemarkeerd.

Daarom moet je endpoint idempotent zijn. UPSERT op event_id; bij duplicaat retourneer 200 zonder opnieuw te notificeren. Verwerp ook verzoeken met timestamp ouder dan 5 minuten om replay-aanvallen te beperken.

FAQ

Kost het iets? Nee, gratis voor alle actieve affiliates.

Testmodus? Ja, "Send Test Event"-knop in het dashboard.

Secret kwijt? Regenereer; de oude wordt direct ingetrokken.

Was dit nuttig? Deel het.