查询用户卡列表
GET/openapi/v2/cards/list| 项 | 内容 |
|---|---|
| 请求方法 | GET |
| 请求路径 | /openapi/v2/cards/list |
| 请求类型 | query |
用户标识支持以下两种调用方式,email 和 memberId 必须且只能传一个:
http
GET /openapi/v2/cards/list?email=merchant@example.com
GET /openapi/v2/cards/list?memberId=member_001两种方式都会返回该用户关联的卡列表,响应中的 memberId 以各卡片记录为准。
请求参数:
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
email | string | 条件必填 | 无 | 用户邮箱,和 memberId 二选一,最大 128 个字符。 |
memberId | string | 条件必填 | 无 | 平台成员 ID,和 email 二选一,最大 64 个字符。 |
status | string | 否 | 无 | 按平台卡状态筛选,取值见查询卡详情;不区分大小写,lost 与 cancelled 兼容匹配这两种状态。 |
page | integer | 否 | 1 | 页码。 |
pageSize | integer | 否 | 20 | 每页数量。 |
响应 data:分页结构,items[] 字段同查询卡详情。
本接口读取当前租户的本地卡数据,不会实时向服务方拉取或补入卡片。列表不填充 embossedName、expiryMonth、expiryYear、dailyLimit、singleTransactionLimit、availableLimit、cardLimit、cardEmail;如需产品支持的详情,使用查询卡详情。
如需全量已持卡、共享账户关联、余额及卡账户额度,使用查询用户持卡概览。概览接口不分页,单项余额或额度查询失败时仍保留卡列表。
