S2S Postback Avanceret Affiliate-opsætning med HMAC

Doğa driver et performance-marketingbureau i Şişli, Istanbul, og sender som affiliate 38 restauranter ind hos thMenu. Da hun skiftede fra manuel rapportering til S2S postback, steg hendes ROI med 220 %, fordi alle commission-events nu flyder automatisk ind i hendes attribuerings­platform.

Hvorfor S2S Postback

S2S postback er en direkte, browserløs databro mellem din trackingserver og thMenus commission-engine. I modsætning til pixels er den immun over for cookietab, adblockere og Apples ITP. Doğa genererer 1.200+ events om måneden.

I thMenu Phase 3 udløser hvert event — created, refunded, released — en POST til den registrerede URL. Payloaden er HMAC-SHA256-signeret i headeren X-thMenu-Signature.

Dashboard-opsætning

Tre trin i Settings → Postback:

1. Indsæt din endpoint i feltet Postback URL (HTTPS påkrævet). 2. Aktivér Enabled; systemet genererer en 64-tegns secret. 3. Kopiér secret én gang — den vises aldrig igen efter reload.

Doğa gemmer secret som Vercel-miljøvariabel THMENU_POSTBACK_SECRET. Endpoint verificerer signaturen, skriver til Postgres og svarer 401 ved ugyldighed.

Payload og retry

JSON-payloaden indeholder event_type, affiliate_id, commission_id, amount_cents, currency, timestamp og idempotency_key mod dubletter.

Ved fejl forsøger thMenu 5 gange med eksponentiel backoff (1m, 5m, 30m, 2t, 12t), derefter "dead"-markering og super-admin-alert.

FAQ

Hvordan verificerer jeg signaturen? Beregn HMAC-SHA256 af raw body med din secret og sammenlign timing-safe med headeren.

Hvis jeg mister min secret? Deaktivér og genaktivér postback — en ny secret genereres med det samme.

Hvilke tiers? Alle aktive affiliates uden tier-begrænsning.

Var dette nyttigt? Del det.