Affiliate Postback URL: K Čemu Slouží Tvůrcům

Affiliate tvůrkyně z Ankary chtěla, aby její Discord kanál dostal okamžité upozornění pokaždé, když během živé koučovací relace přišla nová provize. Řešení přinesla postback URL z Phase 3.

Jak to funguje

V affiliate dashboardu otevři Settings → Postback URL. Vlož endpoint, zapni toggle a klikni na Generate Signing Secret. Tajný klíč je 32znakový hex řetězec zobrazený jen jednou; pak žije v databázi pouze jako hash.

Při každé události (created, refunded, released) worker POSTuje na tvou URL s hlavičkou X-thMenu-Signature: sha256=<hmac>. Na své straně HMAC přepočítáš a porovnáš constant-time.

Reálné scénáře

Nejsilnější vzor pro tvůrce je integrace s Discord webhookem. Tvůrkyně z Ankary živě vysílala 320 členům: "Někdo právě použil můj kód — 47 USD provize". Engagement se za hodinu ztrojnásobil.

Další cíle: Slack boti, osobní CRM HubSpot nebo Notion, toky Zapier/Make do Google Sheets, Telegram push, e-mailové souhrny pro účetní. Každý typ události lze zpracovat jinak.

Spolehlivost

Pokud endpoint nevrátí 2xx do 5 sekund, worker zapíše selhání do affiliate_postback_log. Každou hodinu retry cron zkusí znovu — až 5 pokusů s exponenciálním backoff (1m, 5m, 30m, 2h, 6h). Po pátém selhání je událost mrtvá.

Proto musí být endpoint idempotentní. UPSERT podle event_id; při duplicitě vrať 200 bez opětovné notifikace. Odmítej také požadavky se starším timestampem než 5 minut kvůli replay útokům.

FAQ

Je to placené? Ne, zdarma pro všechny aktivní affiliate.

Testovací režim? Ano, tlačítko "Send Test Event" v dashboardu.

Ztratil jsem klíč? Vygeneruj nový; starý je okamžitě zneplatněn.

Bylo to užitečné? Sdílejte to.