跳转到主要内容
POST
Create PAN Token

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。 更多信息参见 关联账户

x-idempotency-key
string<uuid>
必填

用于维持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败的情况下保持数据一致性。

路径参数

id
string<uuid>
必填

资源的全局唯一标识符(UUID v4)。

示例:

"71fdb0fe-9682-457a-9361-e8868694f12f"

响应

200 - application/json

成功创建 PAN Token。

token
string
必填

pan_ 前缀的一次性 JWT Token,用于通过 secure iframe 访问敏感卡数据。

示例:

"pan_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"

expires_in
integer
必填

Token 有效期,单位秒。

示例:

60

expires_at
string
必填

Token 过期时间戳,ISO 8601 格式。

示例:

"2025-11-13T10:31:00Z"