Affiliate Postback URL: Hvad Gør Det For Skabere

En affiliate-skaber fra Ankara ville have, at hendes Discord-kanal modtog en notifikation øjeblikkeligt, hver gang en ny commission kom ind under hendes live coaching-session. Løsningen kom med postback URL fra Phase 3.

Sådan virker det

I affiliate-dashboardet åbn Settings → Postback URL. Indsæt dit endpoint, slå toggle til og klik på Generate Signing Secret. Den hemmelige nøgle er en 32-tegns hex-streng, der kun vises én gang; derefter lever den kun som hash i databasen.

Ved hver event (created, refunded, released) sender worker POST til din URL med header X-thMenu-Signature: sha256=<hmac>. Du genberegner HMAC server-side og sammenligner i constant-time.

Rigtige scenarier

Det stærkeste mønster for skabere er Discord webhook-integration. Ankara-skaberen sendte live til sine 320 coaching-medlemmer: "Nogen brugte lige min kode — 47 USD commission". Engagementet tredobledes på en time.

Andre destinationer: Slack-bots, personlige HubSpot eller Notion CRM'er, Zapier/Make flows til Google Sheets, Telegram push, og e-mail-resuméer til revisor. Hver event-type kan håndteres forskelligt.

Pålidelighed

Hvis dit endpoint ikke returnerer 2xx inden 5 sekunder, skriver worker en fejl til affiliate_postback_log. Hver time forsøger en retry-cron igen — op til 5 forsøg med eksponentiel backoff (1m, 5m, 30m, 2t, 6t). Efter femte fejl markeres eventen død.

Derfor skal dit endpoint være idempotent. UPSERT efter event_id; ved duplikat returnér 200 uden at notificere igen. Afvis også requests med timestamp ældre end 5 minutter for at reducere replay-angreb.

FAQ

Koster det? Nej, gratis for alle aktive affiliates.

Test-tilstand? Ja, "Send Test Event"-knap i dashboardet.

Mistet hemmelig nøgle? Regenerer; den gamle inddrages øjeblikkeligt.

Var dette nyttigt? Del det.