Skip to main content
使用者存取權杖是短期有效的 JWT。當它過期時,使用與先前相同的 generateUserAccessToken 呼叫來鑄造新的權杖即可——對於使用 API 金鑰的應用程式,沒有獨立的重新整理流程。
你需要: 你的 API Key(在沙盒中使用你的 Test API Key),以及在 Developer Console 中與之並列顯示的 User IDAccount ID
1

再次呼叫 generateUserAccessToken

以你的憑證替換 <YOUR_SANDBOX_API_KEY><YOUR_USER_ID><YOUR_ACCOUNT_ID>
2

儲存新權杖

回應包含一個新的存取權杖,帶有你所要求的範圍:
複製 token 的值,並如同先前一樣,在已驗證的請求中將其放入 Authorization: Bearer <YOUR_USER_ACCESS_TOKEN> 標頭。
主動鑄造權杖——例如在每次作業或工作階段開始時——而不是等到收到 401 再被動重新鑄造。這能避免在高負載下發生請求失敗。
在客戶帳戶上運作的 OAuth 平台應用程式,應改為透過 OAuth 權杖重新整理端點來重新整理客戶權杖——請參閱重新整理 OAuth 存取權杖

後續步驟

快速開始:你的第一筆禮品卡購買

拿到有效的權杖後,端到端執行完整的 happy path——存入資金、購買禮品卡,並在沙盒中查看。