跳转到内容

查询用户卡列表 ​

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 以各卡片记录为准。

请求参数:

字段类型必填默认值说明
emailstring条件必填无用户邮箱,和 memberId 二选一,最大 128 个字符。
memberIdstring条件必填无平台成员 ID,和 email 二选一,最大 64 个字符。
statusstring否无按平台卡状态筛选,取值见查询卡详情;不区分大小写,lost 与 cancelled 兼容匹配这两种状态。
pageinteger否1页码。
pageSizeinteger否20每页数量。

响应 data:分页结构,items[] 字段同查询卡详情。

本接口读取当前租户的本地卡数据,不会实时向服务方拉取或补入卡片。列表不填充 embossedName、expiryMonth、expiryYear、dailyLimit、singleTransactionLimit、availableLimit、cardLimit、cardEmail;如需产品支持的详情,使用查询卡详情。

如需全量已持卡、共享账户关联、余额及卡账户额度,使用查询用户持卡概览。概览接口不分页,单项余额或额度查询失败时仍保留卡列表。