卡详情
POST
/{{version}}/openApi/card/getCard
使用场景
获取卡详情。
请求参数
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| customer_id | long | 是 | 客户id |
| app_id | long | 是 | 应用id |
| key | string | 是 | 授权key |
| card_id | int | 是 | 卡 id |
{
"customer_id": 10000011,
"app_id": 100001,
"key": "ae9ae3f5ad284ef4836de18aa3d41c47",
"card_id": "9790d83fbb935e1d134e03bb505c2de5"
}
响应内容
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| app_id | long | 是 | 应用 id |
| card_id | string | 是 | 卡 id |
| bin_id | string | 是 | bin id |
| holder_id | string | 是 | 持卡人 id |
| holder | object | 是 | 持卡人快照 |
| holder.holder_id | string | 是 | 持卡人id |
| holder.first_name | string | 是 | first_name |
| holder.last_name | string | 是 | last_name |
| holder.country | string | 是 | country |
| holder.province | string | 是 | province |
| holder.city | string | 是 | city |
| holder.address | string | 是 | address |
| holder.post_code | string | 是 | post_code |
| holder.phone_number | string | 是 | phone_number |
| holder.email | string | 是 | |
| card_no | string | 是 | 卡号 |
| balance | float | 是 | 余额，单位：元 |
| limit | float | 是 | 累计充值，单位：元 |
| expiry | string | 是 | 过期时间, 月/年 |
| cvv | string | 是 | cvv |
| pin | string | 是 | pin |
| status | int | 是 | 状态 1:未激活 2:已激活 3:已冻结 4:销卡中 5:已销卡 6:已挂失 7:已补卡 |
| use_at | datetime | 是 | 激活时间 |
| close_at | datetime | 是 | 发起销卡时间 |
| end_at | datetime | 是 | 完成销卡时间 |
{
"code": 0,
"message": "success",
"data": {
"code": 0,
"message": "success",
"data": {
"app_id": 100005,
"card_id": "cid_7tcguVk2jppBS8v8",
"bin_id": "cpi_6530de6a2f1c7",
"holder_id": "hid_RTX87a7XqeEgQH6e",
"holder": {
"holder_id": "hid_RTX87a7XqeEgQH6e",
"first_name": "",
"last_name": "",
"country": "US",
"province": "IL",
"city": "Rockford",
"address": "200 West State Street",
"post_code": "61101",
"phone_number": "",
"email": ""
},
"card_no": "90697338691754192896",
"balance": 0,
"limit": 10,
"expiry": "03/28",
"cvv": "345",
"pin": "",
"status": 5,
"use_at": "2025-04-08 07:33:04",
"close_at": "2025-05-06 02:57:17",
"end_at": "2025-05-06 02:57:20",
"mark": ""
}
}
}
请求参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-03-19 06:16:48