跳轉到主要內容
當你目前的使用者存取權杖過期時,使用與其一同取得的更新權杖交換新的存取權杖—無需重新跑完整的憑證流程。
你需要: 你的 API Key(在沙盒中使用你的 Test API Key)以及發行存取權杖時一併回傳的 Refresh Token
1

呼叫 refreshUserAccessToken

<YOUR_SANDBOX_API_KEY><YOUR_REFRESH_TOKEN> 替換為你的憑證:
2

儲存新的權杖

回應會包含一個新的存取權杖,其擁有與先前發行之權杖相同的 scopes:
複製 token 的值,並像先前一樣在已驗證的請求中使用於 Authorization: Bearer <YOUR_USER_ACCESS_TOKEN> 標頭。也請一併儲存新的 refreshToken——你之後再次重新整理時會需要它。
主動在目前的權杖到期前進行重新整理,而不是等到收到 401 後才被動重新整理。這能避免在高負載下請求失敗。

下一步

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

持有有效權杖後,從頭到尾跑一次完整 happy path——存入資金、購買禮品卡,並在沙盒中揭露它。