開發者向幫助目次
ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南（錢包應用程式、店鋪向 Webhook、Survey API）、依資料領域別指南、運用與安全性、社群、疑難排解。
什麼是應用程式登錄
說明 ReceiptRoller 的應用程式登錄的概念。透過將應用程式登錄為 OAuth 用戶端，會發行用戶端 ID、密鑰、重新導向 URI，可開始 API、Webhook 串接。
利用開始為止的流程
說明 ReceiptRoller 的開發者入口利用開始為止的流程。作為店鋪使用者登錄，只要是 Starter 方案以上，無需另行的開發者申請即可立刻開始應用程式登錄與 API 實作。
SNS Webhook 旁路（LINE 等外部 SNS 的 Webhook 轉發）
解說 ReceiptRoller 將從 LINE 等 SNS 平台接收到的 Webhook，在店鋪端同意下轉發至開發者應用程式的「SNS Webhook 旁路」功能的機制、設定方法、簽章的處理、注意事項。
CrmCustomerDto 參考
解說 ReceiptRoller 顧客主檔 CrmCustomerDto 的所有欄位。從 POS（Smaregi、Square）匯入的顧客資訊會正規化為此模型。
錢包應用程式向：以 OAuth 取得使用者的收據的指南
解說從 iOS、Android、LINE Mini App 等錢包型應用程式，在使用者同意下取得 ReceiptRoller 的購買收據的方法。涵蓋 OAuth 2.0 驗證、收據 API、Webhook 串接。
Survey API and receipt embed
ReceiptRoller 的問卷功能讓店鋪透過 QR／連結／數位收據嵌入收集回答，並可選擇性地回饋優惠券。本文涵蓋公開消費者 API、收據嵌入酬載，以及店鋪可附加至活動的觀眾鎖定規則。
Webhook 的登錄方法
解說在 ReceiptRoller 的開發者入口登錄 Webhook 端點的步驟、訂閱事件的選法、測試投放、多端點的分開運用、刪除與暫停的方法。
重新導向 URL 的設定
解說在 ReceiptRoller 的開發者入口設定的重新導向 URI（回呼 URL）的角色、登錄規則、開發與正式環境的分別使用、常見錯誤與因應方法。
回傳 403/401（權限、權限範圍）
API 呼叫回傳 401 或 403 時的原因釐清。解說權杖無效、權限範圍不足、無店鋪存取權、User 系審查未通過等典型情況。
API 參考與文件的閱讀方式
說明 ReceiptRoller 的開發者向文件的構成與分別使用。開發者幫助、API 頂頁、Swagger 基底的 API 參考、開發者社群的 4 個入口，以及可用於 AI 助手或程式碼生成工具的 OpenAPI 規格（openapi/v1.json）的取得方法。
Webhook 的概要
解說 ReceiptRoller 的 Webhook 所投放的主要事件種類、應該使用 Webhook 而非輪詢的理由、投放形式（HTTPS POST + JSON）、投放保證的思考方式。
商品主檔（PIM）、類別資料
解說 ReceiptRoller 的商品主檔（PIM）、類別、變體的資料結構、CRUD 操作、SKU 管理、與 EC 的同步模式。