エラーコードとリトライ指針
レシートローラーAPIが返すHTTPステータスコードとエラーコードの一覧、リトライすべきケース、リトライ間隔の指針を解説します。
データ保護（匿名化・暗号化）の考え方
レシートローラー連携アプリでのデータ保護の考え方、暗号化（保管時・通信時）、匿名化・仮名化のテクニック、削除ポリシーを解説します。
商品管理API（Products API）の使い方
レシートローラーの商品管理API（/api/v1/products）でビジネスアカウント配下の商品をCRUD操作するためのガイドです。Android／iOSアプリやサーバー連携でPIM（商品マスター）を読み書きする際の入門記事です。
ビジネスアカウント・店舗・POS端末の一覧を取得する
レシートローラーのモバイルアプリ／サーバーアプリから、ユーザーが所属するビジネスアカウント、その配下の店舗、各店舗のPOS端末をREST APIで一覧する手順をまとめます。
User系スコープでapp_not_approvedが返る
User系スコープを使うとapp_not_approvedエラーが返る場合の確認手順。サンドボックス枠での開発、審査申請、サンドボックス本番化の流れを解説します。
監視と失敗時の対応
レシートローラーWebhookの配信履歴の見方、監視すべき指標とアラート設計、デッドレターの再配信、よくある障害パターンと復旧手順を解説します。
Webhookが届かない
Webhookが受信エンドポイントに届かないときの原因切り分け。エンドポイント設定・購読イベント・到達性・署名検証失敗・ファイアウォールなどを順に確認する手順を解説します。
403/401が返る（権限・スコープ）
API呼び出しで401や403が返るときの原因切り分け。トークン無効・スコープ不足・店舗アクセス権なし・User系審査未通過などの典型ケースを解説します。
User系スコープの審査申請
レシートローラーで一般消費者のデータ（user.* スコープ）を扱うアプリに必要な審査申請の流れ、提出書類、審査基準、審査期間、よくある差し戻し理由を解説します。
店舗内メディアディスプレイAPI（Display API）の使い方
レシートローラーの店舗内 Android ディスプレイ向け API（/api/v1/displays/*）の概要とペアリング・ハートビート・プレイリスト取得・再生実績報告の手順をまとめます。Android キオスクや店舗サイネージ端末でメディアループを再生するアプリを実装するための入門ガイドです。
CrmCustomerDto リファレンス
レシートローラーの顧客マスタである CrmCustomerDto の全フィールドを解説します。POS（スマレジ・Square）から取り込まれた顧客情報がこのモデルに正規化されます。
ProductDto リファレンス
レシートローラーの商品マスタ（PIM）である ProductDto の全フィールドを解説します。POS（Square）からの商品カタログ同期、原価・店舗別価格・バリエーション・プレオーダーなどの構造をまとめています。
StaffDto リファレンス
レシートローラーのスタッフ（従業員）マスタである StaffDto の全フィールドを解説します。POS（Square Team / スマレジ）との関連付け、店舗アサイン、雇用形態などの構造をまとめています。
OAuthスコープ一覧と利用可否
レシートローラーのOAuth APIで利用できるスコープの一覧と、各スコープがどの種類のアプリに付与されるかを説明します。User系スコープの審査要件、Store系とUser系を混在できない理由、LIFFアプリからの利用方法もカバーします。
ウォレットアプリ向け：ユーザーのレシートをOAuthで取得するガイド
iOS・Android・LINE Mini Appなどのウォレット型アプリから、ユーザーの同意のもとで Receipt Roller の購買レシートを取得する方法を解説します。OAuth 2.0認証・レシートAPI・Webhook連携をカバーします。
店舗向け：自社アプリでデジタルレシートを発行・Webhookで通知するガイド
店舗・ブランドが自社アプリでデジタルレシートをお客様に発行し、Webhookでリアルタイム通知を受け取るまでの手順を解説します。アプリ登録・OAuth・Webhook設定・署名検証をカバーします。