S2S Postback Avancerad Affiliate-installation med HMAC

Doğa driver en performance-marknadsföringsbyrå i Şişli, Istanbul, och skickar som affiliate 38 restauranger till thMenu. Efter att ha bytt från manuell rapportering till S2S postback ökade hennes ROI med 220 %, eftersom varje provisionshändelse nu flödar automatiskt in i hennes attributionsplattform.

Varför S2S Postback

S2S postback är en direkt, webbläsarlös databrygga mellan din trackingserver och thMenus provisionsmotor. Till skillnad från pixel är den immun mot cookieförlust, adblockers och Apples ITP. Doğa genererar 1 200+ events per månad.

I thMenu Phase 3 utlöser varje event — created, refunded, released — en POST till registrerad URL. Payloaden är HMAC-SHA256-signerad i headern X-thMenu-Signature.

Dashboard-installation

Tre steg i Settings → Postback:

1. Klistra in din endpoint i fältet Postback URL (HTTPS krävs). 2. Slå på Enabled; systemet genererar en 64-teckens secret. 3. Kopiera secret en gång — den visas aldrig igen efter omladdning.

Doğa lagrar secret som Vercel-miljövariabel THMENU_POSTBACK_SECRET. Endpoint verifierar signaturen, skriver till Postgres och svarar 401 vid ogiltighet.

Payload och retry

JSON-payloaden innehåller event_type, affiliate_id, commission_id, amount_cents, currency, timestamp och idempotency_key mot dubbletter.

Vid fel försöker thMenu 5 gånger med exponentiell backoff (1m, 5m, 30m, 2t, 12t), sedan "dead"-markering och super-admin-larm.

FAQ

Hur verifierar jag signaturen? Beräkna HMAC-SHA256 av rå body med din secret och jämför timing-safe med headern.

Om jag tappar min secret? Inaktivera och återaktivera postback — ny secret genereras omedelbart.

Vilka tiers? Alla aktiva affiliates utan tier-begränsning.

Var detta hjälpsamt? Dela det.