User 系權限範圍回傳 app_not_approved

疑難排解 User系權限範圍 審查
事象
呼叫使用 user.receipts.readuser.* 權限範圍的 API 時,回傳 app_not_approved 錯誤。

原因

User 系權限範圍若未經 ReceiptRoller 的審查而被承認,就無法對營運公司內的測試使用者以外使用。這會在嘗試授權一般消費者,或在已審查的測試使用者以外使用時發生。

3 種情況

情況 1:開發中尚未申請審查

因應:建立開發用應用程式(測試應用程式),使用營運公司內的測試使用者(自家成員)搭配沙箱框架。無法對一般消費者公開授權流程。

情況 2:審查申請中

因應:在審查完成前無法對正式使用者使用。審查狀態可在開發者入口網站 → 應用程式 → 「權限範圍」分頁確認。

情況 3:已審查但對特定使用者失敗

因應:該使用者可能取消了應用程式的授權。請導引至重新授權流程。

確認步驟

  1. 開發者入口網站 → 應用程式 → 開啟「權限範圍」分頁
  2. 確認相關 user.* 權限範圍的狀態
    • 「未申請」→ 需要申請
    • 「審查中」→ 等待完成
    • 「承認」→ 可正式使用
    • 「駁回」→ 確認理由後重新申請
  3. 明明是「承認」卻失敗時,請備妥錯誤回應的 request_id 與相關使用者 ID 聯繫支援

在沙箱框架下的開發

若為營運公司的成員(員工),審查前也可嘗試 User 系權限範圍。

  1. 建立開發用應用程式(測試應用程式)
  2. 啟用「沙箱框架」
  3. 以營運公司的成員執行授權流程
  4. 即可呼叫 API

此沙箱框架僅限定於營運公司內的成員。無法對公司外使用者或測試者以外公開。

轉移至正式環境

在沙箱框架完成動作確認後,另行登錄正式應用程式並申請審查。沒有將沙箱的應用程式直接轉為正式環境的機制。

相關指南

發布日: 2026-04-27 更新日: 2026-07-06