錯誤處理
處理驗證、授權、過期與 scope 相關的失敗。
| 狀態碼 | 常見原因 | 下一步 |
|---|---|---|
401 | Client 憑證或 Partner access token 無效。 | 停止使用該憑證；輪替或重新授權。 |
403 | 商業 context 已停用、membership 非 active、client 已停用，或缺少 kyc.ocr.read。 | 停止授權，並檢查 Organization、Merchant、membership、client 狀態與已授予的 scopes。 |
404 | 找不到 verified identity 或已核准的 KYC 申請。 | 請使用者先完成 eKYC。 |
409 | 缺少 KYC 前置條件，或 code 無效、過期、已被使用。 | 重新發起授權；永遠不要重試同一個 code。 |
422 | 未知的 client、redirect URI 不符，或 scope 不被允許。 | 修正串接設定。 |
429 | 超過 endpoint 的速率限制。 | 採用 backoff，不要立即重複同一請求。 |
Laravel 驗證失敗會回傳 JSON message 與 errors 物件。業務失敗會回傳 JSON message，在移除 secret 與個資後可直接用於 log。
目前每分鐘的限制為：每個 throttle key 30 次 preview、20 次 authorization、30 次 token exchange，以及 /me 與 /kyc-application 各 60 次。