開發者入口可做的事
概觀 ReceiptRoller 的開發者入口可做的事。組合 REST API 的資料取得、操作與 Webhook 的即時事件接收，可從外部系統串接店鋪、使用者資料。
員工管理 API（Staff API）的使用方式
這是使用 ReceiptRoller 員工管理 API（/api/v1/staff）對商業帳戶底下的員工（Staff）進行 CRUD 操作的指南。支援與 Square Team Member 互通的欄位（假名、多工作分配、薪資結構）。
簽章驗證與安全性
解說 ReceiptRoller Webhook 的 HMAC-SHA256 簽章驗證的機制、驗證程式碼的範例（Node.js / Python / C#）、重放攻擊對策、密鑰的安全管理方法。
重送、順序、冪等性的設計
解說 ReceiptRoller Webhook 的重送政策、投放順序不保證的理由、使用 event_id 的冪等性實作、無效信件的處理、常見反模式。
SLA、稼動率與故障時的確認步驟
解說 ReceiptRoller API 的稼動率目標、狀態頁面的確認方法、故障發生時的釐清步驟，以及支援升級的流程。
PosTransactionDto 規格 — 交易資料的欄位參考
解說 ReceiptRoller 處理的交易資料正規模型 PosTransactionDto 的所有欄位。依識別碼、日期時間、金額、明細、付款、員工、狀態、CRM 串接各類別，彙整欄位名稱、型別、意義，以及各 POS 供應商的填入方式，是給開發者與外部系統串接負責人的參考。Smaregi、Square 雙方的對應文章也會參照本文。
CrmCustomerDto 參考
解說 ReceiptRoller 顧客主檔 CrmCustomerDto 的所有欄位。從 POS（Smaregi、Square）匯入的顧客資訊會正規化為此模型。
ProductDto 參考
解說 ReceiptRoller 商品主檔（PIM）ProductDto 的所有欄位。彙整來自 POS（Square）的商品目錄同步，以及原價、各店鋪價格、變體、預購等結構。
回傳 403/401（權限、權限範圍）
API 呼叫回傳 401 或 403 時的原因釐清。解說權杖無效、權限範圍不足、無店鋪存取權、User 系審查未通過等典型情況。
StaffDto 參考
解說 ReceiptRoller 員工（Staff）主檔 StaffDto 的所有欄位。彙整與 POS（Square Team / Smaregi）的關聯、店鋪指派、雇用型態等結構。
Survey API and receipt embed
ReceiptRoller 的問卷功能讓店鋪透過 QR／連結／數位收據嵌入收集回答，並可選擇性地回饋優惠券。本文涵蓋公開消費者 API、收據嵌入酬載，以及店鋪可附加至活動的觀眾鎖定規則。