ウォレットアプリ向け：ユーザーのレシートをOAuthで取得するガイド
iOS・Android・LINE Mini Appなどのウォレット型アプリから、ユーザーの同意のもとで Receipt Roller の購買レシートを取得する方法を解説します。OAuth 2.0認証・レシートAPI・Webhook連携をカバーします。
購買・レシートデータ連携
レシートローラーが扱う購買・レシートデータの構造、取得方法、関連スコープ、Webhook、よくあるユースケースを解説します。
利用できるデータ領域
レシートローラーの開発者ポータルから取得できるデータ領域を一覧で説明します。取引・商品・在庫・受注・顧客・クーポン・SNS・広告・個人ユーザーデータなど、各領域に含まれる内容と取得方法、必要なスコープをまとめています。
OAuthスコープ一覧と利用可否
レシートローラーのOAuth APIで利用できるスコープの一覧と、各スコープがどの種類のアプリに付与されるかを説明します。User系スコープの審査要件、Store系とUser系を混在できない理由、LIFFアプリからの利用方法もカバーします。
Webhookで新しい売上を受け取り、Slackに通知する
receipt.created Webhookを登録し、Node.jsで署名検証と重複除去をしてSlackに売上を投稿するまでを手順で説明します。
代表的なAPI例
レシートローラーAPIの代表的なエンドポイントの呼び出し例（レシート取得・店舗一覧・商品作成・Webhook登録）をcurlコマンドで紹介します。
はじめてのAPI呼び出し：アプリ登録から取引一覧の取得まで
OAuth認可コードフロー（PKCE）でトークンを取得し、ビジネスアカウントを確認して取引一覧を取得、トークンを更新するまでを通して行います。
店舗の予約を自社のカレンダーに表示する
予約管理APIで店舗の7日分の予約を取得し、Node.jsでiCalendar（.ics）ファイルに書き出してカレンダーに表示する手順です。
User系スコープの審査申請
レシートローラーで一般消費者のデータ（user.* スコープ）を扱うアプリに必要な審査申請の流れ、提出書類、審査基準、審査期間、よくある差し戻し理由を解説します。
商品マスタを自社システムと同期する
手元のCSV・JSONを読み、SKUで照合して商品を作成・差分更新するNode.jsスクリプトを、商品APIで作ります。
データ保護（匿名化・暗号化）の考え方
レシートローラー連携アプリでのデータ保護の考え方、暗号化（保管時・通信時）、匿名化・仮名化のテクニック、削除ポリシーを解説します。
利用目的・接続先（POS／EC／分析など）の申告
レシートローラーの開発者ポータルでアプリを登録する際に申告する「利用目的」と「接続先カテゴリ」（POS／EC／分析／CRM／OMS／WMS／SNS／その他）の意味、選び方、変更時の注意、User系スコープ審査との関連を解説します。
アカウント連携・統合API（トークン交換・/me/identities・/account/merge）
ネイティブアプリやLINEミニアプリから、LINE・Apple・GoogleのIDトークンでサインインし、ログイン方法の追加・解除とアカウントの統合を行うAPIの仕様とエラーコードです。
帳票・請求関連データ（対応範囲）
レシートローラーが扱う帳票・請求関連データの対応範囲、税率レポート、インボイス制度対応、会計ソフト連携の指針を解説します。
レート制限とスロットリング
レシートローラーAPIでリクエスト数の制限があるエンドポイントと上限、429の返り方、クライアント側の流量の抑え方とリトライ方針を説明します。
Webhookの概要
実際に送信されるWebhookイベント、届くリクエストの形と署名ヘッダー、重複・順序・取りこぼしの扱い、APIとの使い分けを説明します。
開発者ポータルでできること
レシートローラーの開発者ポータルでできることを概観します。REST APIによるデータ取得・操作、Webhookによるリアルタイムイベント受信を組み合わせて、外部システムから店舗・ユーザーデータを連携できます。
監視と失敗時の対応
Webhookの有効状態・最終送信日時・配信ログの見方と、自動で無効になったことに気づいて復旧し、抜けた期間をAPIで補う方法を説明します。
アクセストークンの取得と更新
アクセストークン（8時間）とリフレッシュトークン（30日）の取得・更新の手順、更新ごとの入れ替わり、使えなくなるケースを説明します。