notifyUrl に HTTPS POST リクエストを送信します。
Webhook を使用する理由
- 決済結果の正本(リダイレクトやポーリングよりも優先度が高い)
- ユーザーフローをブロックしない非同期通知
- すべてのステータス変更イベントをカバー
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Waffo Webhook による非同期イベント通知の概要と設定要件。
notifyUrl に HTTPS POST リクエストを送信します。
| 要件 | 説明 |
|---|---|
| プロトコル | HTTPS (TLS 1.2 以上) |
| 到達性 | パブリックインターネットからアクセス可能であること |
| 署名 | Waffo はリクエストボディを Waffo の秘密鍵で署名します。加盟店は Waffo の公開鍵を使って X-SIGNATURE を検証する必要があります |
| 応答ボディ | {"message": "success"} / {"message": "failed"} / {"message": "unknown"} |
{
"header": {
"Content-Type": "application/json",
"X-SIGNATURE": "..."
},
"body": {
"eventType": "PAYMENT_NOTIFICATION",
"result": { ... }
}
}
{
"header": {
"Content-Type": "application/json"
},
"body": {
"message": "success"
}
}
| 応答 | 説明 |
|---|---|
success | 正常に受信・処理した |
failed | 処理失敗。Waffo は再送します |
unknown | ステータス不明。Waffo は再送します |
# cloudflared
cloudflared tunnel --url http://localhost:3000
# ngrok
ngrok http 3000
このページは役に立ちましたか?