Affiliate Postback URL: Mitä Se Tekee Sisällöntuottajille

Ankarassa toiminut affiliate-tekijä halusi Discord-kanavansa saavan ilmoituksen heti, kun uusi komissio saapui hänen live coaching -sessionsa aikana. Vastaus oli Phase 3:n postback URL.

Toiminta

Avaa affiliate-kojelaudassa Settings → Postback URL. Liitä endpoint, kytke toggle päälle ja klikkaa Generate Signing Secret. Salaisuus on 32-merkkinen hex-merkkijono, joka näytetään vain kerran; sen jälkeen se elää tietokannassa hash-muodossa.

Jokaisen tapahtuman (created, refunded, released) yhteydessä worker lähettää POSTin otsikolla X-thMenu-Signature: sha256=<hmac>. Sinä lasket HMACin omalla puolellasi ja vertaat constant-time-tavalla.

Käytännön skenaariot

Vahvin malli tekijöille on Discord webhook -integraatio. Ankaran tekijä lähetti livenä 320 coaching-jäsenelleen: "Joku käytti juuri koodiani — 47 USD komissio". Engagement kolminkertaistui tunnissa.

Muita kohteita: Slack-botit, henkilökohtaiset HubSpot tai Notion CRM:t, Zapier/Make-virrat Google Sheetsiin, Telegram-push ja sähköpostiyhteenvedot kirjanpitäjälle. Jokainen tapahtumatyyppi käsiteltävissä erikseen.

Luotettavuus

Jos endpointtisi ei palauta 2xx 5 sekunnissa, worker kirjaa epäonnistumisen affiliate_postback_log-tauluun. Tunneittainen retry-cron yrittää uudelleen — enintään 5 yritystä eksponentiaalisella backoffilla (1m, 5m, 30m, 2h, 6h). Viidennen jälkeen tapahtuma merkitään kuolleeksi.

Siksi endpointin on oltava idempotentti. UPSERT event_id:llä; duplikaatissa palauta 200 ilman uutta notifikointia. Hylkää myös yli 5 minuuttia vanhat aikaleimat replay-hyökkäysten estämiseksi.

UKK

Maksullinen? Ei, maksuton kaikille aktiivisille affiliateille.

Testitila? Kyllä, "Send Test Event" -nappi kojelaudassa.

Salaisuus kateissa? Luo uusi; vanha mitätöityy heti.

Oliko tästä hyötyä? Jaa se.