X-SIGNATURE が含まれており、Waffo の秘密鍵で署名されています。加盟店は Waffo の公開鍵を使用して署名を検証する必要があります。
Waffo 公開鍵の取得
マーチャントポータル → Integration メニューにログインすると、Waffo 公開鍵を確認してコピーできます。このページにアクセスするには、Dev または Admin ロールの権限が必要です。
推奨アプローチ: SDK を使用する
SDK のhandleWebhook() メソッドは、署名検証、イベント解析、ルーティング、応答ボディの構築を自動的に実行します。
手動での検証
SDK を使用せず手動で処理する必要がある場合、検証手順は以下のとおりです。1
署名の取得
リクエストヘッダーから
X-SIGNATURE を取得します。2
生のボディの取得
生のリクエストボディ文字列を取得します (JSON のパース後に再度文字列化しないでください)。
3
署名の検証
Waffo 公開鍵と SHA256WithRSA を使用して署名を検証します。
4
イベントの処理
署名検証が通ったあとにイベントを処理します。