Skip to main content
用户访问令牌是短期有效的 JWT。令牌过期后,使用与首次获取相同的 generateUserAccessToken 调用重新铸造新令牌——对于使用 API Key 的应用,没有单独的刷新流程。
你需要: 你的 API Key(在沙盒中使用你的 Test API Key),以及在开发者控制台中与其一起显示的 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——充值资金、购买礼品卡,并在沙盒中展示它。