POST
查询持卡人列表
使用此接口查询商户账户下的持卡人。
请求
ApiKeyOnerway 分配的发卡 API key 请求 Header。
示例：
replace_with_issuing_api_keymerchantNo商户号筛选条件；仅在已开通跨商户查询权限时使用。
示例：
88888cardholderId持卡人 ID 筛选条件。
示例：
300001clientRequestId幂等请求 ID 筛选条件。
示例：
REQ_CH_20260101_001pageNum页码。
示例：
1约束
- 范围
1
pageSize每页条数。
示例：
10约束
- 范围
1100
curl -X POST 'https://sandbox-api.onerway.com/api/v1/merchant/cardholder/queryCardholder' \
-H 'ApiKey: replace_with_issuing_api_key' \
-H 'Content-Type: application/json' \
--data-raw '{
"pageNum": 1,
"pageSize": 10
}'响应
respCode业务响应码；
20000 表示成功。respMsg响应信息。
data{ records, total, ... }分页持卡人查询结果。
{
"respCode": "20000",
"respMsg": "success",
"data": {
"records": [
{
"cardholderId": 300001,
"firstName": "Alex",
"lastName": "Chen",
"email": "example_cardholder@example.com",
"mobile": null,
"mobileAreaCode": null,
"birthDay": null,
"nationality": "CN",
"addressRegionCode": "CN",
"addressStateCode": "GD",
"addressCityCode": "SZ",
"addressDetailLine1": "Example address line 1",
"addressDetailLine2": null,
"addressPostalCode": "518000",
"remark": null
}
],
"total": 1,
"current": 1,
"size": 10
}
}该接口暂未记录错误响应。