レシートローラーで最も中心にあるデータがレシート（receipt）です。1回の決済が1レシートに対応し、複数の明細（item）を持ちます。POSや自社決済システムから発行され、店舗系・User系の両方のスコープでアクセスできます。

主なフィールド

関連スコープ

• receipt.read — 店舗のレシート読み取り
• receipt.write — レシートの新規発行・取消
• user.receipts.read — 一般消費者本人のレシート（要審査）
• user.receipts.write — 本人のレシートにメモ・タグ追加（要審査）

取得パターン

店舗オーナーとして取得

GET /v1/receipts?store_id=str_abc123&issued_after=2026-04-01
Authorization: Bearer {店舗トークン}

消費者本人として取得

GET /v1/me/receipts?limit=20
Authorization: Bearer {ユーザートークン}

Webhookイベント

• receipt.issued — 発行
• receipt.voided — 取消
• receipt.refunded — 返金
• receipt.updated — 内容更新（補足追加など）

よくあるユースケース

• 会計連携：日次でレシートを取得して会計ソフトに登録
• 消費者向けレシート管理アプリ：本人レシートを家計簿アプリに同期
• BI集計：時間帯別・商品別の売上分析
• 不正検知：返金率の異常値検知

注意点

• 明細を含むレシートはペイロードが大きいため、一覧取得時は明細を含めない（?expand=items で明示時のみ含む）
• 取消・返金された場合、元レシートは残り status が変わる。集計時は status を必ず参照
• 金額は税込・税抜の両方が total_amount / subtotal として提供される

関連ガイド

• ウォレットアプリ向けレシート取得ガイド
• 店舗向けレシート発行・Webhookガイド
• OAuthスコープ一覧
• 開発者ヘルプトップへ戻る