開發者向幫助目次
ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南（錢包應用程式、店鋪向 Webhook、Survey API）、依資料領域別指南、運用與安全性、社群、疑難排解。
取得商業帳戶、店鋪、POS 端末的一覽
彙整從行動應用程式／伺服器應用程式以 REST API 一覽使用者所屬商業帳戶、其底下的店鋪、各店鋪 POS 端末的步驟。
商品管理 API（Products API）的使用方式
這是使用 ReceiptRoller 商品管理 API（/api/v1/products）對商業帳戶底下的商品進行 CRUD 操作的指南。適用於在 Android／iOS 應用程式或伺服器串接讀寫 PIM（商品主檔）時的入門文章。
員工管理 API（Staff API）的使用方式
這是使用 ReceiptRoller 員工管理 API（/api/v1/staff）對商業帳戶底下的員工（Staff）進行 CRUD 操作的指南。支援與 Square Team Member 互通的欄位（假名、多工作分配、薪資結構）。
商店應用程式 內容 API（公告、頁面、營業資訊）的使用方式
說明用於取得商店應用程式內容（公告、頁面、應用程式資訊清單、營業資訊、會員卡設定）的 /api/v1/apps/{shopId}/* 使用方式。解說 shopId 與商業帳戶 ID 相同、商業帳戶層級內容與店鋪層級內容的差異，以及驗證的處理方式。
無法取得權杖（驗證錯誤）
無法取得存取權杖時的原因釐清。解說 invalid_client、invalid_grant、redirect_uri_mismatch 等代表性錯誤與因應。
預約管理 API（Reservations API）的使用方式
ReceiptRoller 預約管理 API（/api/v1/reservations）的指南。解說預約的 CRUD、狀態更新，預約框（時段）的取得、建立、整批產生，店鋪版面所登錄的座位（桌位、包廂、吧台）的取得，以及預約統計。
Webhook 的登錄方法
解說在 ReceiptRoller 的開發者入口登錄 Webhook 端點的步驟、訂閱事件的選法、測試投放、多端點的分開運用、刪除與暫停的方法。
交易一覽 API（Transactions API：POS＋OMS 整合摘要）的使用方式
ReceiptRoller 的 Transactions API 是將收銀營業額（PosTransactions）與銷售管理訂單（OmsOrders）整合為單一摘要的唯讀 API。在 Android／iOS 應用程式中一覽顯示「整個商業帳戶的交易」時，即為入口。
銷售管理 API（Orders / OMS API）的使用方式
這是使用 ReceiptRoller 銷售管理 API（/api/v1/orders）對商業帳戶底下的訂單進行 CRUD 操作的指南。彙整訂單的建立、更新、狀態轉移（確認、處理中、取消）、刪除，以及適用於 Android／iOS 應用程式或伺服器串接的流程。
重送、順序、冪等性的設計
解說 ReceiptRoller Webhook 的重送政策、投放順序不保證的理由、使用 event_id 的冪等性實作、無效信件的處理、常見反模式。
SLA、稼動率與故障時的確認步驟
解說 ReceiptRoller API 的稼動率目標、狀態頁面的確認方法、故障發生時的釐清步驟，以及支援升級的流程。
營業時間 API（Business Hours API）的使用方式
ReceiptRoller 營業時間 API（/api/v1/stores/{storeId}/business-hours）的指南。解說每個星期的營業時間的取得與更新、特別營業日（臨時歇業、營業時間變更）的登錄、店鋪的可營業時間（排班建立時的上限業務時間）的設定，以及目前是否營業中的判定。
營業額實績 API（Sales API）的使用方式
彙整 ReceiptRoller 營業額實績 API（/api/v1/sales/*）的概要，以及依商業帳戶、店鋪、POS 端末、期間的篩選方法。這是一份涵蓋實際回應結構（KpiValue 巢狀型）與 averageTicket、權杖有效期限（8 小時）在內，為在 Android／iOS 行動應用程式或伺服器串接實作營業額儀表板的入門指南。
StaffDto 參考
解說 ReceiptRoller 員工（Staff）主檔 StaffDto 的所有欄位。彙整與 POS（Square Team / Smaregi）的關聯、店鋪指派、雇用型態等結構。
API 參考與文件的閱讀方式
說明 ReceiptRoller 的開發者向文件的構成與分別使用。開發者幫助、API 頂頁、Swagger 基底的 API 參考、開發者社群的 4 個入口，以及可用於 AI 助手或程式碼生成工具的 OpenAPI 規格（openapi/v1.json）的取得方法。
Survey API and receipt embed
ReceiptRoller 的問卷功能讓店鋪透過 QR／連結／數位收據嵌入收集回答，並可選擇性地回饋優惠券。本文涵蓋公開消費者 API、收據嵌入酬載，以及店鋪可附加至活動的觀眾鎖定規則。