開發者向幫助目次
ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南（錢包應用程式、店鋪向 Webhook、Survey API）、依資料領域別指南、運用與安全性、社群、疑難排解。
重送、順序、冪等性的設計
解說 ReceiptRoller Webhook 的重送政策、投放順序不保證的理由、使用 event_id 的冪等性實作、無效信件的處理、常見反模式。
SNS Webhook 旁路（LINE 等外部 SNS 的 Webhook 轉發）
解說 ReceiptRoller 將從 LINE 等 SNS 平台接收到的 Webhook，在店鋪端同意下轉發至開發者應用程式的「SNS Webhook 旁路」功能的機制、設定方法、簽章的處理、注意事項。
新增建立應用程式
說明在 ReceiptRoller 的開發者入口登錄新的應用程式（OAuth 用戶端）的具體步驟。涵蓋輸入項目、驗證、建立後的憑證顯示、常見錯誤。
商店應用程式 內容 API（公告、頁面、營業資訊）的使用方式
說明用於取得商店應用程式內容（公告、頁面、應用程式資訊清單、營業資訊、會員卡設定）的 /api/v1/apps/{shopId}/* 使用方式。解說 shopId 與商業帳戶 ID 相同、商業帳戶層級內容與店鋪層級內容的差異，以及驗證的處理方式。
利用目的、串接對象（POS／EC／分析等）的申告
解說在 ReceiptRoller 的開發者入口登錄應用程式時申告的「利用目的」與「串接對象類別」（POS／EC／分析／CRM／OMS／WMS／SNS／其他）的意義、選法、變更時的注意、與 User 系權限範圍審查的關聯。
店鋪資訊 API（Store Information API）的使用方式
說明如何以 REST API 取得、更新店鋪的基本資訊（店鋪名稱、店鋪類別、聯絡方式、地址）。可從員工應用程式等以權杖驗證的用戶端實作店鋪資訊的編輯畫面。
可利用的資料領域
以一覽說明可從 ReceiptRoller 的開發者入口取得的資料領域。彙整交易、商品、庫存、訂單、顧客、優惠券、SNS、廣告、個人使用者資料等，各領域含的內容與取得方法、必要的權限範圍。
利用開始為止的流程
說明 ReceiptRoller 的開發者入口利用開始為止的流程。作為店鋪使用者登錄，只要是 Starter 方案以上，無需另行的開發者申請即可立刻開始應用程式登錄與 API 實作。
OAuth 權限範圍一覽與利用可否
說明 ReceiptRoller 的 OAuth API 可利用的權限範圍的一覽，與各權限範圍被授予哪種類型的應用程式。也涵蓋 User 系權限範圍的審查要件、Store 系與 User 系無法混在的理由、從 LIFF 應用程式的利用方法。
Webhook 的概要
解說 ReceiptRoller 的 Webhook 所投放的主要事件種類、應該使用 Webhook 而非輪詢的理由、投放形式（HTTPS POST + JSON）、投放保證的思考方式。
Webhook 的登錄方法
解說在 ReceiptRoller 的開發者入口登錄 Webhook 端點的步驟、訂閱事件的選法、測試投放、多端點的分開運用、刪除與暫停的方法。
營業時間 API（Business Hours API）的使用方式
ReceiptRoller 營業時間 API（/api/v1/stores/{storeId}/business-hours）的指南。解說每個星期的營業時間的取得與更新、特別營業日（臨時歇業、營業時間變更）的登錄、店鋪的可營業時間（排班建立時的上限業務時間）的設定，以及目前是否營業中的判定。
什麼是應用程式登錄
說明 ReceiptRoller 的應用程式登錄的概念。透過將應用程式登錄為 OAuth 用戶端，會發行用戶端 ID、密鑰、重新導向 URI，可開始 API、Webhook 串接。
PosTransactionDto 規格 — 交易資料的欄位參考
解說 ReceiptRoller 處理的交易資料正規模型 PosTransactionDto 的所有欄位。依識別碼、日期時間、金額、明細、付款、員工、狀態、CRM 串接各類別，彙整欄位名稱、型別、意義，以及各 POS 供應商的填入方式，是給開發者與外部系統串接負責人的參考。Smaregi、Square 雙方的對應文章也會參照本文。