URL di Postback Affiliazione: A Cosa Serve ai Creator

Una creator affiliata di Ankara voleva ricevere una notifica Discord ogni volta che entrava una nuova commissione durante la sua sessione di coaching live. La soluzione è arrivata con la postback URL della Phase 3.

Come funziona

Nel pannello affiliato apri Settings → Postback URL. Incolla il tuo endpoint, attiva il toggle e clicca Generate Signing Secret. Il secret è una stringa hex di 32 caratteri mostrata una sola volta; poi vive solo come hash nel database.

Quando si verifica un evento — created, refunded o released — il worker manda POST con header X-thMenu-Signature: sha256=<hmac>. Ricalcoli l'HMAC dal tuo lato e verifichi la firma in constant-time.

Scenari reali

Il pattern più potente per i creator è il webhook Discord. La creator di Ankara ha trasmesso in diretta ai suoi 320 membri: "Qualcuno ha appena usato il mio codice — 47 USD di commissione". L'engagement si è triplicato in un'ora.

Altre destinazioni: bot Slack, CRM personali HubSpot o Notion, flussi Zapier/Make verso Google Sheets, canali Telegram e riepiloghi email. Ogni tipo di evento può essere gestito diversamente.

Affidabilità

Se il tuo endpoint non risponde 2xx in 5 secondi, il worker registra il fallimento in affiliate_postback_log. Ogni ora un cron riprova fino a 5 volte con backoff esponenziale (1m, 5m, 30m, 2h, 6h). Al quinto fallimento l'evento è marcato morto.

Per questo l'endpoint deve essere idempotente. UPSERT per event_id; in caso di duplicato rispondi 200 senza notificare di nuovo. Rifiuta anche richieste con timestamp più vecchio di 5 minuti per mitigare replay.

FAQ

È a pagamento? No, gratuito per tutti gli affiliati attivi.

Modalità test? Sì, pulsante "Send Test Event" nel pannello.

Secret perso? Rigeneralo; il vecchio è revocato immediatamente.

Ti è stato utile? Condividilo.