跳转到主要内容
POST
Reset Card PIN

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

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

x-idempotency-key
string<uuid>
必填

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

请求体

application/json
card_id
string<uuid>
必填

卡片的唯一标识符。

示例:

"5135e6cc-28b6-4889-81dc-3b86a09e1395"

pin
string
必填

卡片的新 PIN 码,必须为 6 位数字。

示例:

"123456"

响应

200 - application/json

成功设置卡片 PIN 码。

request_status
enum<string>
必填

请求状态。

可用选项:
SUCCESS