持卡人详情
POST
/{{version}}/openApi/holder/getHolder
使用场景
编辑持卡人，持卡人状态”待审批“ 或 ”审批拒绝“ 时，可进行编辑。
请求参数
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| customer_id | long | 是 | 客户id |
| app_id | long | 是 | 应用id |
| key | string | 是 | 授权key |
| holder_id | long | 是 | 持卡人 id |
{
"customer_id": 10000011,
"app_id": 100001,
"key": "ae9ae3f5ad284ef4836de18aa3d41c47",
"holder_id":1000001
}
响应内容
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| holder_id | long | 是 | 持卡人 id |
| customer_id | long | 是 | 客户 id |
| first_name | string | 是 | 中文 名 |
| last_name | string | 是 | 中文 姓 |
| first_name_en | string | 是 | 英文 名 |
| last_name_en | string | 是 | 英文 姓 |
| gender | int | 是 | 性别 1:男 2:女 |
| birthday | date | 是 | 出生日期 |
| marital_status | int | 是 | 婚姻状态 1:已婚; 2:未婚 |
| nationality | string | 是 | 国籍, 如 USA |
| contact_area | string | 是 | 联系号码区号 |
| contact_no | string | 是 | 联系号码 |
| string | 是 | 邮箱 | |
| address | string | 是 | 地址 |
| province | string | 是 | 州/省 |
| city | string | 是 | 城市 |
| country | string | 是 | 国家 |
| post_code | string | 是 | 邮编 |
| id_card_type | int | 是 | 证件类型 |
| id_card_no | string | 是 | 证件号 |
| id_card_front | string | 是 | 证 件正面照 url |
| id_card_back | string | 否 | 证件背面照 url |
| handwritten_signature | string | 是 | 手写签名照 url |
| status | int | 是 | 状态 |
| reject_reason | string | 是 | 拒绝原因 |
| create_at | datetime | 是 | 创建时间 |
{
"code": 0,
"message": "success",
"data": {
"holder_id": 1000001,
"customer_id": 10000011,
"first_name": "first_name",
"last_name": "last_name",
"first_name_en": "first_name_en",
"last_name_en": "last_name_en",
"gender": 1,
"birthday": "1990-10-28",
"marital_status": 1,
"nationality": "CN",
"contact_area": "+86",
"contact_no": "13722338876",
"email": "xxx@xxx.com",
"address": "address......",
"province": "广东省",
"city": "深圳市",
"country": "CN",
"post_code": "518000",
"id_card_type": 1,
"id_card_no": "440304199010282934",
"id_card_front": "http://34.92.44.10:8000/storage/customer/customerFile?o=/cardHolder/10000011/cardHolderIdCardFront_383c88505df44903b27aa25398761ba1.png",
"id_card_back": "http://34.92.44.10:8000/storage/customer/customerFile?o=/cardHolder/10000011/cardHolderIdCardBack_cf15f0e3f9d745fe9fbfd1d101c6db66.png",
"handwritten_signature": "http://34.92.44.10:8000/storage/customer/customerFile?o=/cardHolder/10000011/HandwrittenSignature_13b552ae1548490bb6841f96b335cef6.png",
"status": 2,
"reject_reason": "",
"create_at": "2023-10-24 06:16:39"
}
}
请求参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-03-19 06:16:48