curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"status": "Approved",
"total_balance": "1000.00",
"time": 1716307200000,
"card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
"account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
}
}
持卡人相关
获取持卡人详细信息
GET
/
open-api
/
v1
/
cardholder
/
{cardholder_no}
/
info
curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"status": "Approved",
"total_balance": "1000.00",
"time": 1716307200000,
"card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
"account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
}
}
获取持卡人详情,含账户与成功卡列表。
请求头
apiKey(商户凭证,与 IP 白名单绑定)
Unix 时间戳(毫秒),与服务端偏差须在 60 秒内,且不接受未来时间戳
登录标识(除获取 Token 外必填)
固定为
application/json路径参数
持卡人单号
返回参数
响应状态码,
0 表示成功响应消息
返回数据
显示 data
显示 data
持卡人单号
商户侧持卡人唯一单号
邮箱
持卡人状态,见【附录-常量表】持卡人状态
账户总资产(USD)
持卡人创建时间(Unix 毫秒)
curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"status": "Approved",
"total_balance": "1000.00",
"time": 1716307200000,
"card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
"account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
}
}
⌘I
