店舗向け：自社アプリでデジタルレシートを発行・Webhookで通知するガイド
店舗・ブランドが自社アプリでデジタルレシートをお客様に発行し、Webhookでリアルタイム通知を受け取るまでの手順を解説します。アプリ登録・OAuth・Webhook設定・署名検証をカバーします。
本番運用のベストプラクティス
レシートローラー連携アプリを本番運用するためのベストプラクティス（環境分離、監視、デプロイ、障害対応、ドキュメント整備）を解説します。
取引一覧API（Transactions API：POS＋OMS統合フィード）の使い方
レシートローラーのTransactions APIは、レジ売上（PosTransactions）と販売管理注文（OmsOrders）を1つのフィードに統合した読み取り専用APIです。Android／iOSアプリで「ビジネスアカウント全体の取引」を一覧表示する際の入り口になります。
商品管理API（Products API）の使い方
レシートローラーの商品管理API（/api/v1/products）でビジネスアカウント配下の商品をCRUD操作するためのガイドです。Android／iOSアプリやサーバー連携でPIM（商品マスター）を読み書きする際の入門記事です。
Webhookの概要
レシートローラーのWebhookで配信される主要なイベント種別、ポーリングではなくWebhookを使うべき理由、配信形式（HTTPS POST + JSON）、配信保証の考え方を解説します。
トークンが取得できない（認証エラー）
アクセストークンが取得できないときの原因切り分け。invalid_client、invalid_grant、redirect_uri_mismatch などの代表的エラーと対処を解説します。
User系スコープの審査申請
レシートローラーで一般消費者のデータ（user.* スコープ）を扱うアプリに必要な審査申請の流れ、提出書類、審査基準、審査期間、よくある差し戻し理由を解説します。
署名検証とセキュリティ
レシートローラーWebhookのHMAC-SHA256署名検証の仕組み、検証コードのサンプル（Node.js / Python / C#）、リプレイ攻撃対策、シークレットの安全な管理方法を解説します。
エンドポイントとバージョニング
レシートローラーAPIのベースURL、バージョニング方針、廃止予告の流れ、現行バージョンの確認方法を解説します。
User系スコープでapp_not_approvedが返る
User系スコープを使うとapp_not_approvedエラーが返る場合の確認手順。サンドボックス枠での開発、審査申請、サンドボックス本番化の流れを解説します。
アプリを新規作成する
レシートローラーの開発者ポータルで新しいアプリ（OAuthクライアント）を登録する具体的な手順を説明します。入力項目・バリデーション・作成後のクレデンシャル表示・よくあるエラーまでをカバーします。
従業員管理API（Staff API）の使い方
レシートローラーの従業員管理API（/api/v1/staff）でビジネスアカウント配下の従業員（スタッフ）をCRUD操作するためのガイドです。Square Team Member 互換のフィールド（カナ名、複数業務割当、給与構造）に対応しています。
ウォレットアプリ向け：ユーザーのレシートをOAuthで取得するガイド
iOS・Android・LINE Mini Appなどのウォレット型アプリから、ユーザーの同意のもとで Receipt Roller の購買レシートを取得する方法を解説します。OAuth 2.0認証・レシートAPI・Webhook連携をカバーします。
PosTransactionDto 仕様 — 取引データのフィールドリファレンス
レシートローラーが扱う取引データの正規モデル PosTransactionDto の全フィールドを解説します。識別子・日時・金額・明細・支払い・スタッフ・ステータス・CRM 連携の各カテゴリーごとに、フィールド名・型・意味・各 POS ベンダーからの埋め方をまとめた、開発者および外部システム連携担当者向けのリファレンスです。スマレジ・Square 双方のマッピング記事からも参照されます。
再送・順序・冪等性の設計
レシートローラーWebhookの再送ポリシー、配信順序が保証されない理由、event_idを使った冪等性の実装、デッドレターの扱い、よくあるアンチパターンを解説します。
監視と失敗時の対応
レシートローラーWebhookの配信履歴の見方、監視すべき指標とアラート設計、デッドレターの再配信、よくある障害パターンと復旧手順を解説します。
SNS Webhookバイパス（LINEなど外部SNSのWebhook転送）
レシートローラーがLINE等のSNSプラットフォームから受け取ったWebhookを、店舗側の同意のもとで開発者アプリへ転送する「SNS Webhookバイパス」機能の仕組み、設定方法、署名の取り扱い、注意点を解説します。
ネイティブモバイルアプリ向けガイド: 複数ビジネスアカウントアクセスと OAuth フロー
Android / iOS のネイティブアプリ向け実装ガイド。アプリ登録時に「認可時に1つのビジネスアカウントへトークンを紐付ける」をオフにすると、user-scoped OAuth トークンが発行されます。/api/v1/me/organizations + ?organizationId= パターンで複数ビジネスアカウントを横断アクセスできます。
利用できるデータ領域
レシートローラーの開発者ポータルから取得できるデータ領域を一覧で説明します。取引・商品・在庫・受注・顧客・クーポン・SNS・広告・個人ユーザーデータなど、各領域に含まれる内容と取得方法、必要なスコープをまとめています。
販売管理API（Orders / OMS API）の使い方
レシートローラーの販売管理API（/api/v1/orders）でビジネスアカウント配下の受注をCRUD操作するためのガイドです。注文の作成・更新・状態遷移（確認・処理中・キャンセル）・削除と、Android／iOSアプリやサーバー連携向けのフローをまとめます。