10 筆
2026-04-27
疑難排解
權杖
驗證
OAuth
無法取得權杖（驗證錯誤）
無法取得存取權杖時的原因釐清。解說 invalid_client、invalid_grant、redirect_uri_mismatch 等代表性錯誤與因應。
2026-04-27
app-registration
oauth
client
developer-portal
新增建立應用程式
說明在 ReceiptRoller 的開發者入口登錄新的應用程式（OAuth 用戶端）的具體步驟。涵蓋輸入項目、驗證、建立後的憑證顯示、常見錯誤。
2026-04-27
疑難排解
User系權限範圍
審查
User 系權限範圍回傳 app_not_approved
使用 User 系權限範圍時回傳 app_not_approved 錯誤時的確認步驟。解說在沙箱框架下的開發、審查申請、沙箱轉正式環境的流程。
2026-04-27
OAuth
重新導向URI
應用程式登錄
安全性
重新導向 URL 的設定
解說在 ReceiptRoller 的開發者入口設定的重新導向 URI（回呼 URL）的角色、登錄規則、開發與正式環境的分別使用、常見錯誤與因應方法。
2026-04-27
Webhook
簽章驗證
HMAC
安全性
重放攻擊
簽章驗證與安全性
解說 ReceiptRoller Webhook 的 HMAC-SHA256 簽章驗證的機制、驗證程式碼的範例（Node.js / Python / C#）、重放攻擊對策、密鑰的安全管理方法。
2026-05-29
PosTransactionDto
交易資料
綱要
參考
API
Smaregi
Square
POS串接
PosTransactionDto 規格 — 交易資料的欄位參考
解說 ReceiptRoller 處理的交易資料正規模型 PosTransactionDto 的所有欄位。依識別碼、日期時間、金額、明細、付款、員工、狀態、CRM 串接各類別，彙整欄位名稱、型別、意義，以及各 POS 供應商的填入方式，是給開發者與外部系統串接負責人的參考。Smaregi、Square 雙方的對應文章也會參照本文。
2026-04-27
api
reference
swagger
openapi
community
API 參考與文件的閱讀方式
說明 ReceiptRoller 的開發者向文件的構成與分別使用。開發者幫助、API 頂頁、Swagger 基底的 API 參考、開發者社群的 4 個入口，以及可用於 AI 助手或程式碼生成工具的 OpenAPI 規格（openapi/v1.json）的取得方法。