User 系權限範圍回傳 app_not_approved
疑難排解
User系權限範圍
審查
事象
呼叫使用
呼叫使用
user.receipts.read 等 user.* 權限範圍的 API 時,回傳 app_not_approved 錯誤。
原因
User 系權限範圍若未經 ReceiptRoller 的審查而被承認,就無法對營運公司內的測試使用者以外使用。這會在嘗試授權一般消費者,或在已審查的測試使用者以外使用時發生。
3 種情況
情況 1:開發中尚未申請審查
因應:建立開發用應用程式(測試應用程式),使用營運公司內的測試使用者(自家成員)搭配沙箱框架。無法對一般消費者公開授權流程。
情況 2:審查申請中
因應:在審查完成前無法對正式使用者使用。審查狀態可在開發者入口網站 → 應用程式 → 「權限範圍」分頁確認。
情況 3:已審查但對特定使用者失敗
因應:該使用者可能取消了應用程式的授權。請導引至重新授權流程。
確認步驟
- 開發者入口網站 → 應用程式 → 開啟「權限範圍」分頁
- 確認相關
user.*權限範圍的狀態- 「未申請」→ 需要申請
- 「審查中」→ 等待完成
- 「承認」→ 可正式使用
- 「駁回」→ 確認理由後重新申請
- 明明是「承認」卻失敗時,請備妥錯誤回應的
request_id與相關使用者 ID 聯繫支援
在沙箱框架下的開發
若為營運公司的成員(員工),審查前也可嘗試 User 系權限範圍。
- 建立開發用應用程式(測試應用程式)
- 啟用「沙箱框架」
- 以營運公司的成員執行授權流程
- 即可呼叫 API
此沙箱框架僅限定於營運公司內的成員。無法對公司外使用者或測試者以外公開。
轉移至正式環境
在沙箱框架完成動作確認後,另行登錄正式應用程式並申請審查。沒有將沙箱的應用程式直接轉為正式環境的機制。
相關指南
發布日: 2026-04-27
更新日: 2026-07-06
標籤
API (22)
OAuth (15)
Android (10)
iOS (9)
Webhook (8)
api (7)
oauth (5)
POS串接 (4)
getting-started (4)
參考 (4)
相關文章
-
無法取得權杖(驗證錯誤)無法取得存取權杖時的原因釐清。解說 invalid_client、invalid_grant、redirect_uri_mismatch 等代表性錯誤與因應。
-
方案仍為免費而不顯示開發者入口網站ReceiptRoller 的開發者入口網站不顯示時的確認步驟。解說方案為免費時的因應方法、商業帳戶切換、顯示反映時機。
-
回傳 403/401(權限、權限範圍)API 呼叫回傳 401 或 403 時的原因釐清。解說權杖無效、權限範圍不足、無店鋪存取權、User 系審查未通過等典型情況。
-
Webhook 沒有送達Webhook 沒有送達接收端點時的原因釐清。依端點設定、訂閱事件、可達性、簽章驗證失敗、防火牆等順序確認的步驟。