密鑰的輪替與安全的保管
解說為安全運用 ReceiptRoller 的用戶端密鑰、Webhook 密鑰的輪替計畫、新舊並行期間的使用方式、保管的最佳實務。
交易一覽 API（Transactions API：POS＋OMS 整合摘要）的使用方式
ReceiptRoller 的 Transactions API 是將收銀營業額（PosTransactions）與銷售管理訂單（OmsOrders）整合為單一摘要的唯讀 API。在 Android／iOS 應用程式中一覽顯示「整個商業帳戶的交易」時，即為入口。
SNS Webhook 旁路（LINE 等外部 SNS 的 Webhook 轉發）
解說 ReceiptRoller 將從 LINE 等 SNS 平台接收到的 Webhook，在店鋪端同意下轉發至開發者應用程式的「SNS Webhook 旁路」功能的機制、設定方法、簽章的處理、注意事項。
商店應用程式 內容 API（公告、頁面、營業資訊）的使用方式
說明用於取得商店應用程式內容（公告、頁面、應用程式資訊清單、營業資訊、會員卡設定）的 /api/v1/apps/{shopId}/* 使用方式。解說 shopId 與商業帳戶 ID 相同、商業帳戶層級內容與店鋪層級內容的差異，以及驗證的處理方式。
ProductDto 參考
解說 ReceiptRoller 商品主檔（PIM）ProductDto 的所有欄位。彙整來自 POS（Square）的商品目錄同步，以及原價、各店鋪價格、變體、預購等結構。
Survey API and receipt embed
ReceiptRoller 的問卷功能讓店鋪透過 QR／連結／數位收據嵌入收集回答，並可選擇性地回饋優惠券。本文涵蓋公開消費者 API、收據嵌入酬載，以及店鋪可附加至活動的觀眾鎖定規則。
CrmCustomerDto 參考
解說 ReceiptRoller 顧客主檔 CrmCustomerDto 的所有欄位。從 POS（Smaregi、Square）匯入的顧客資訊會正規化為此模型。
StaffDto 參考
解說 ReceiptRoller 員工（Staff）主檔 StaffDto 的所有欄位。彙整與 POS（Square Team / Smaregi）的關聯、店鋪指派、雇用型態等結構。
重送、順序、冪等性的設計
解說 ReceiptRoller Webhook 的重送政策、投放順序不保證的理由、使用 event_id 的冪等性實作、無效信件的處理、常見反模式。
Webhook 的登錄方法
解說在 ReceiptRoller 的開發者入口登錄 Webhook 端點的步驟、訂閱事件的選法、測試投放、多端點的分開運用、刪除與暫停的方法。
營業時間 API（Business Hours API）的使用方式
ReceiptRoller 營業時間 API（/api/v1/stores/{storeId}/business-hours）的指南。解說每個星期的營業時間的取得與更新、特別營業日（臨時歇業、營業時間變更）的登錄、店鋪的可營業時間（排班建立時的上限業務時間）的設定，以及目前是否營業中的判定。
監視與失敗時的對應
解說 ReceiptRoller Webhook 的投放紀錄的檢視方式、應監視的指標與警報設計、無效信件的重新投放、常見故障模式與復原步驟。
可利用的資料領域
以一覽說明可從 ReceiptRoller 的開發者入口取得的資料領域。彙整交易、商品、庫存、訂單、顧客、優惠券、SNS、廣告、個人使用者資料等，各領域含的內容與取得方法、必要的權限範圍。
用戶端 ID、用戶端密鑰的管理
解說 ReceiptRoller 應用程式登錄時發行的用戶端 ID、用戶端密鑰的取得方法、保管規則、外洩時的因應、多環境運用。
回傳 403/401（權限、權限範圍）
API 呼叫回傳 401 或 403 時的原因釐清。解說權杖無效、權限範圍不足、無店鋪存取權、User 系審查未通過等典型情況。
PosTransactionDto 規格 — 交易資料的欄位參考
解說 ReceiptRoller 處理的交易資料正規模型 PosTransactionDto 的所有欄位。依識別碼、日期時間、金額、明細、付款、員工、狀態、CRM 串接各類別，彙整欄位名稱、型別、意義，以及各 POS 供應商的填入方式，是給開發者與外部系統串接負責人的參考。Smaregi、Square 雙方的對應文章也會參照本文。