卡列表
POST
/{{version}}/openApi/card/cardList
使用场景
获取卡列表。
请求参数
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| customer_id | long | 是 | 客户id |
| app_id | long | 是 | 应用id |
| key | string | 是 | 授权key |
| bin_id | string | 否 | bin id |
| card_no | string | 否 | 卡号 |
| status | int | 否 | 状态 1:未激活 2:已激活 3:已冻结 4:销卡中 5:已销卡 6:已挂失 7:已补卡 |
| page_no | int | 是 | 页码 |
| page_size | int | 是 | 每页记录数 |
{
"customer_id": 10000011,
"app_id": 100001,
"key": "ae9ae3f5ad284ef4836de18aa3d41c47",
"page_no": 1,
"page_size": 10
}
响应内容
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| total | int | 是 | 总数 |
| page_no | int | 是 | 当前页码 |
| page_size | int | 是 | 当前每页记录数 |
| card_list | array[object] | 是 | 卡数组 |
| card_list.app_id | long | 是 | 应用 id |
| card_list.card_id | string | 是 | 卡 id |
| card_list.bin_id | string | 是 | bin id |
| card_list.holder_id | string | 是 | 持卡人 id |
| card_list.card_no | string | 是 | 卡号 |
| card_list.balance | float | 是 | 余额，单位：元 |
| card_list.limit | float | 是 | 累计充值，单位：元 |
| card_list.expiry | string | 是 | 过期时间, 月/年 |
| card_list.cvv | string | 是 | cvv |
| card_list.pin | string | 是 | pin |
| card_list.status | int | 是 | 状态 1:未激活 2:已激活 3:已冻结 4:销卡中 5:已销卡 6:已挂失 7:已补卡 |
| card_list.use_at | datetime | 是 | 激活时间 |
| card_list.close_at | datetime | 是 | 发起销卡时间 |
| card_list.end_at | datetime | 是 | 完成销卡时间 |
{
"code": 0,
"message": "success",
"data": {
"total": 2,
"page_no": 10,
"page_size": 1,
"card_list": [
{
"app_id": 100001,
"card_id": "82cc95353d901fbcda9fe1385f68f29a",
"bin_id": "cpi_6530de6a2f1c7",
"holder_id": "",
"card_no": "345432552191529",
"balance": 200.5,
"limit": 440.5,
"expiry": "03/28",
"cvv": "715",
"pin": "",
"status": 2,
"use_at": "2023-11-24 02:53:47",
"close_at": "",
"end_at": "",
"mark": ""
},
{
"app_id": 100001,
"card_id": "4b7614889a86efc9249c2c14e349b7a4",
"bin_id": "cpi_6530de6a2f1c7",
"holder_id": "",
"card_no": "4485333916826937",
"balance": 200.5,
"limit": 401.49,
"expiry": "03/28",
"cvv": "183",
"pin": "",
"status": 2,
"use_at": "2023-11-24 02:53:47",
"close_at": "",
"end_at": "",
"mark": ""
}
]
}
}
请求参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-03-19 06:16:48