55 筆 (第 3 頁,共 3 頁)
2026-04-27 API 錯誤碼 重試 HTTP狀態
錯誤碼與重試指引

解說 ReceiptRoller API 回傳的 HTTP 狀態碼與錯誤碼的一覽、應重試的情況、重試間隔的指引。

2026-04-27 收據 購買 資料串接 API
購買、收據資料串接

解說 ReceiptRoller 處理的購買、收據資料的結構、取得方法、相關權限範圍、Webhook、常見使用情境。

2026-04-27 Webhook 監視 警報 無效信件 故障對應
監視與失敗時的對應

解說 ReceiptRoller Webhook 的投放紀錄的檢視方式、應監視的指標與警報設計、無效信件的重新投放、常見故障模式與復原步驟。

2026-05-29 PosTransactionDto 交易資料 綱要 參考 API Smaregi Square POS串接
PosTransactionDto 規格 — 交易資料的欄位參考

解說 ReceiptRoller 處理的交易資料正規模型 PosTransactionDto 的所有欄位。依識別碼、日期時間、金額、明細、付款、員工、狀態、CRM 串接各類別,彙整欄位名稱、型別、意義,以及各 POS 供應商的填入方式,是給開發者與外部系統串接負責人的參考。Smaregi、Square 雙方的對應文章也會參照本文。

2026-04-27 Webhook 重送 冪等性 順序 重試
重送、順序、冪等性的設計

解說 ReceiptRoller Webhook 的重送政策、投放順序不保證的理由、使用 event_id 的冪等性實作、無效信件的處理、常見反模式。

2026-05-29 員工 從業人員 資料模型 參考 POS串接
StaffDto 參考

解說 ReceiptRoller 員工(Staff)主檔 StaffDto 的所有欄位。彙整與 POS(Square Team / Smaregi)的關聯、店鋪指派、雇用型態等結構。

2026-06-03 API OAuth 員工管理 員工 Staff CRUD Android iOS
員工管理 API(Staff API)的使用方式

這是使用 ReceiptRoller 員工管理 API(/api/v1/staff)對商業帳戶底下的員工(Staff)進行 CRUD 操作的指南。支援與 Square Team Member 互通的欄位(假名、多工作分配、薪資結構)。

2026-03-05 API OAuth Webhook 驗證 權限範圍
開發者向幫助目次

ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南(錢包應用程式、店鋪向 Webhook、Survey API)、依資料領域別指南、運用與安全性、社群、疑難排解。

2026-06-01 API OAuth 商品管理 PIM CRUD Android iOS
商品管理 API(Products API)的使用方式

這是使用 ReceiptRoller 商品管理 API(/api/v1/products)對商業帳戶底下的商品進行 CRUD 操作的指南。適用於在 Android/iOS 應用程式或伺服器串接讀寫 PIM(商品主檔)時的入門文章。

2026-04-27 Webhook 簽章驗證 HMAC 安全性 重放攻擊
簽章驗證與安全性

解說 ReceiptRoller Webhook 的 HMAC-SHA256 簽章驗證的機制、驗證程式碼的範例(Node.js / Python / C#)、重放攻擊對策、密鑰的安全管理方法。

2026-04-25 survey api receipt targeting liff
Survey API and receipt embed

ReceiptRoller 的問卷功能讓店鋪透過 QR/連結/數位收據嵌入收集回答,並可選擇性地回饋優惠券。本文涵蓋公開消費者 API、收據嵌入酬載,以及店鋪可附加至活動的觀眾鎖定規則。

2026-04-27 疑難排解 User系權限範圍 審查
User 系權限範圍回傳 app_not_approved

使用 User 系權限範圍時回傳 app_not_approved 錯誤時的確認步驟。解說在沙箱框架下的開發、審查申請、沙箱轉正式環境的流程。

2026-04-27 用戶端ID 密鑰 驗證 應用程式登錄
用戶端 ID、用戶端密鑰的管理

解說 ReceiptRoller 應用程式登錄時發行的用戶端 ID、用戶端密鑰的取得方法、保管規則、外洩時的因應、多環境運用。

2026-06-10 API OAuth 營業時間 Business Hours 特別營業日 可營業時間 排班 Android iOS
營業時間 API(Business Hours API)的使用方式

ReceiptRoller 營業時間 API(/api/v1/stores/{storeId}/business-hours)的指南。解說每個星期的營業時間的取得與更新、特別營業日(臨時歇業、營業時間變更)的登錄、店鋪的可營業時間(排班建立時的上限業務時間)的設定,以及目前是否營業中的判定。

2026-05-29 CRM 顧客 資料模型 參考 POS串接
CrmCustomerDto 參考

解說 ReceiptRoller 顧客主檔 CrmCustomerDto 的所有欄位。從 POS(Smaregi、Square)匯入的顧客資訊會正規化為此模型。