Skip to main content
POST
Get PIN Key

Authorizations

x-auth-token
string
header
required

UQPay 提供的登录 API Token。

Headers

x-client-id
string
required

UQPAY 生成的 API 客户端 ID

x-idempotency-key
string<uuid>
required

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

x-on-behalf-of
string

指定代表哪个子账户发起该请求。应设置为 account_id,可通过 List Connected Accounts 获取。若省略或为空,则使用主账户执行请求。 更多信息见 Connected Accounts

Body

application/json
terminal_id
string
required

UQPAY 终端设备 ID

Example:

"10000005"

prv_key
string
required

用于解密响应中 PIN 密钥的 AES 密钥。

Maximum string length: 64
Example:

"cxwbHl6... "

Response

200 - application/json

成功获取 PIN 密钥

encrypt_pin_key
string
required

加密的 PIN 密钥。使用提供的 prv_key 解密。

Example:

"4usf0C0PfalJuUMJ5CqyD7T+4l4r463G61hTwRqbQyZlH+/YANcQ4iH7akqSGvGdxVbvZOvGMaYRBZzKZmlR3hgXxDaQwfqeGtPkZg=="

pin_key_expire
string<date-time>
required

PIN 密钥的过期时间。

Example:

"2025-12-04T18:18:27.797116587+08:00"

terminal_id
string
required

终端 ID。

Example:

"10000005"