Documentation Index
Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
再送メカニズム
加盟店が{"message": "success"} を返さない場合 (failed/unknown の返却、HTTP 200 以外、リクエストタイムアウト、解析不能な応答)、Waffo は自動的に再送します。
再送戦略
最大で 8 回 (初回通知を含む) 再送します。間隔は徐々に長くなります。| 試行回 | 間隔 | 累積時間 |
|---|---|---|
| 1 回目 | 即時 | 0 |
| 2 回目 | 30 秒 | 30 秒 |
| 3 回目 | 1 分 | 約 1.5 分 |
| 4 回目 | 4 分 | 約 5.5 分 |
| 5 回目 | 30 分 | 約 35 分 |
| 6 回目 | 4 時間 | 約 4.5 時間 |
| 7 回目 | 8 時間 | 約 12.5 時間 |
| 8 回目 | 8 時間 | 約 20.5 時間 |
8 回すべて失敗した場合、通知は恒久的失敗としてマークされ、以降は再送されません。
障害復旧
すべての再送が失敗した場合:- 能動的な照会: 注文照会またはサブスクリプション照会 API を呼び出して最新ステータスを取得する
- リコンサイル: 定期的に注文ステータスを一括照会し、ローカルのレコードと比較する
- サポートへの問い合わせ: Webhook が継続的に届かない場合は、ネットワーク設定を確認するか Waffo テクニカルサポートにお問い合わせください
よくある失敗原因
- 加盟店の
notifyUrlに到達できない (ネットワーク問題、ポートが 80/443 ではない) - 応答ボディが
{"message": "success"}ではない (タイプミスや余分なフィールドなど) - 応答の Content-Type が
application/jsonではない - 応答に
X-SIGNATUREヘッダーが含まれていない - 加盟店サーバーの処理タイムアウト
注意事項
- 再送によってイベントが順不同で到着する場合があります。常に最終ステータスを信頼できる情報源として扱ってください
- Webhook のみに依存せず、能動的な照会をフォールバックとして利用してください
- Webhook 処理ロジックは冪等性を保つようにしてください