跳转到主要内容
POST
/
open-api
/
v1
/
card
/
pin
/
set
curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/pin/set \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --data '{
    "card_no": "C202605220001",
    "cardholder_no": "U202605220001",
    "pin": "Base64EncodedEncryptedPin..."
  }'

{
  "code": 0,
  "msg": "Success",
  "data": {"result": true}
}
设置实体卡 PIN 码。仅支持实体卡（Physical），卡状态须为正常（Activated）。pin 须使用 AES/ECB/PKCS5Padding + Base64 加密后传入。
  • 仅支持实体卡，虚拟卡调用返回 4017
  • 明文 PIN 须为 6 位纯数字，且不可含三位及以上相同或连续数字（如 111111、123456），否则返回 4016
  • 卡状态须为 Activated，否则返回 4005
  • 加密算法详见「代码工具类」章节

​
请求头

​
Api-Key
string
必填
apiKey（商户凭证，与 IP 白名单绑定）
​
Timestamp
string
必填
Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
​
Access-Token
string
必填
登录标识（除获取 Token 外必填）
​
Content-Type
string
默认值:"application/json"
固定为 application/json

​
请求体

​
card_no
string
必填
卡单号
​
cardholder_no
string
必填
持卡人单号
​
pin
string
必填
加密后的 PIN（Base64 密文）

​
返回参数

​
code
number
响应状态码，0 表示成功
​
msg
string
响应消息
​
data
object
返回数据
curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/pin/set \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --data '{
    "card_no": "C202605220001",
    "cardholder_no": "U202605220001",
    "pin": "Base64EncodedEncryptedPin..."
  }'

{
  "code": 0,
  "msg": "Success",
  "data": {"result": true}
}