アフィリエイト Postback URL：クリエイターにとっての役割

アンカラのアフィリエイトクリエイターは,ライブコーチング配信中に新しいコミッションが入った瞬間,Discord チャンネルに通知を飛ばしたいと考えました。答えは Phase 3 で導入された postback URL です。

仕組み

アフィリエイトダッシュボードで Settings → Postback URL を開きます。エンドポイントを貼り付け,トグルを有効化し,Generate Signing Secret をクリック。シークレットは 32 文字の hex 文字列で,一度だけ表示され,以降はハッシュとして DB に保管されます。

イベント (created,refunded,released) のたびに,worker が X-thMenu-Signature: sha256=<hmac> ヘッダー付きで POST します。受信側で HMAC を再計算し定数時間比較で検証します。

活用シーン

クリエイターに最強なのは Discord webhook 連携です。アンカラのクリエイターはコーチングコミュニティの 320 メンバーに「誰かが今コードを使った — 47 USD コミッション」とライブ中に通知し,1 時間で engagement が 3 倍になりました。

他の宛先:Slack ボット,個人の HubSpot または Notion CRM,Zapier/Make 経由で Google Sheets に追記,Telegram プッシュ,経理向けメールダイジェスト。イベント種別ごとに処理を変えられます。

信頼性

エンドポイントが 5 秒以内に 2xx を返さない場合,worker は affiliate_postback_log に失敗を記録します。毎時の retry cron が指数バックオフ (1分,5分,30分,2時間,6時間) で最大 5 回再試行。5 回目で dead 扱いです。

そのためエンドポイントは冪等である必要があります。event_id で UPSERT し,重複時は 200 を返して再通知を防ぐ。timestamp が 5 分以上古いリクエストは拒否してリプレイ攻撃を緩和してください。

FAQ

有料? いいえ,アクティブなアフィリエイト全員が無料で使えます。

テストモード? あります。「Send Test Event」ボタンで疑似ペイロード送信。

シークレットを紛失した? 再生成すれば旧シークレットは即時失効します。

お役に立ちましたか?シェアしてください。