Receipt Roller 側でなにかが起きたときに、自動的に外部システムへ通知を送りたい場合は Webhook を使います。ポーリング不要で、リアルタイムにイベントを受け取れます。

Webhookを登録する

• 組織管理画面の「開発者」→「Webhook」を開く
• 「新規登録」から受信URL（HTTPS必須）と受け取りたいイベントを選ぶ
• 署名検証用のシークレットが発行されるので保存する

主なイベント

• 売上・注文イベント（新規売上、返金、キャンセル）
• レシートイベント（電子レシート発行、ダウンロード）
• 商品・在庫イベント（価格変更、在庫変動）
• 店舗・従業員イベント（店舗追加、従業員追加・退職）

受信側での実装ポイント

• 送信される署名ヘッダーを検証してください（なりすまし防止）
• 2xx 系のレスポンスを素早く返してください。処理は非同期で行うことを推奨します
• 失敗時は自動でリトライされます。冪等な処理にしてください

開発者向けのくわしい情報

各イベントのペイロード仕様、署名検証のサンプルコード、リトライ間隔などは開発者ヘルプをご覧ください。

https://receiptroller.io/ja-JP/developer/help

関連記事

• デベロッパーAPIの概要
• APIリファレンスの参照