跳转到主要内容
当你当前的用户访问令牌过期时,使用随之一起收到的刷新令牌交换获取一个新的访问令牌——无需重新运行完整的凭证流程。
你将需要: 你的 API Key(在沙盒中使用你的 Test API Key)以及签发访问令牌时返回的 Refresh Token
1

调用 refreshUserAccessToken

<YOUR_SANDBOX_API_KEY><YOUR_REFRESH_TOKEN> 替换为你的凭证:
2

存储新令牌

响应包含一个新的访问令牌,其携带的权限范围与之前签发的令牌相同:
复制 token 的值,并像之前一样在经过身份验证的请求中将其用于 Authorization: Bearer <YOUR_USER_ACCESS_TOKEN> 标头。也请存储新的 refreshToken——你在下次刷新时还会用到它。
主动在当前令牌过期之前进行刷新,而不是等待收到 401 后再被动刷新。这样可以避免在高负载下请求失败。

后续步骤

快速开始:你的第一笔礼品卡购买

拿到有效令牌后,端到端跑通完整的快乐路径——存入资金、购买礼品卡,并在沙盒中进行展示。