curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--header 'Timezone: UTC+8' \
--data '{
"cardholder_no": "",
"cardholder_unique_no": "",
"start_time": "2026-01-01",
"end_time": "2026-03-31",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [
{
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"fail_reason": "",
"status": "",
"time": 1716307200000
}
]
}
}
持卡人相关
获取持卡人列表
POST
/
open-api
/
v1
/
cardholder
/
list
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--header 'Timezone: UTC+8' \
--data '{
"cardholder_no": "",
"cardholder_unique_no": "",
"start_time": "2026-01-01",
"end_time": "2026-03-31",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [
{
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"fail_reason": "",
"status": "",
"time": 1716307200000
}
]
}
}
查询指定时间范围内的持卡人列表，支持按持卡人单号、商户侧唯一单号筛选，并支持分页。
请求头
string
必填
apiKey（商户凭证，与 IP 白名单绑定）
string
必填
Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
string
必填
登录标识（除获取 Token 外必填）
string
默认值:"UTC+8"
时区，影响
start_time / end_time 的日界计算，默认 UTC+8string
默认值:"application/json"
固定为
application/json请求体
string
持卡人单号
string
商户侧持卡人唯一单号
string
必填
开始时间（格式：
yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss）string
必填
结束时间（同上；间隔 ≤90 天）
number
默认值:"0"
查询页码，默认
0number
默认值:"10"
查询条数，默认
10（最多查询 100 条）返回参数
number
响应状态码，
0 表示成功string
响应消息
object
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--header 'Timezone: UTC+8' \
--data '{
"cardholder_no": "",
"cardholder_unique_no": "",
"start_time": "2026-01-01",
"end_time": "2026-03-31",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [
{
"cardholder_no": "",
"cardholder_unique_no": "",
"email": "",
"fail_reason": "",
"status": "",
"time": 1716307200000
}
]
}
}