请求URL

POST {域名}/api/vas/card/v2/query

请求参数

加密数据dataContent

序号 域名 变量名 必填 长度 备注
01. 卡唯一编号 cardId O String 卡唯一编号
02. 卡片类型 cardType M String 0：常规卡
1：共享附属卡
03. 创建起始时间 beginTime M String 格式yyyy-MM-dd HH:mm:ss
04. 创建结束时间 endTime M String 格式yyyy-MM-dd HH:mm:ss
05. 状态 cardStatus O int 1：使用中
2：已销卡
0：冻结
06. 当前页数 currentPage M int 正整数
07. 分页大小 pageSize M int 最大100
08. 要查询的用户号/子用户号 queryUserNo M Number 要查询的用户号/子用户号，为空时表示查询名下所有母+子，(注：建议传下对应用户号以提升查询响应速度)

dataContent示例

{
    "beginTime": "2026-01-06 22:09:11",
    "cardStatus": 1,
    "cardType": "1",
    "currentPage": 1,
    "endTime": "2026-06-07 22:10:11",
    "pageSize": 10
}

响应参数

结果信息result

序号 域名 变量名 必填 长度 备注
1. 总条数 totalCount M Number
2. 当前页数 currentPage M Number
3. 分页大小 pageSize M Number
4. 总页数 totalPages M Number
5. 明细 list O List<Object>

list 明细:

序号 域名 变量名 必填 长度 备注
01. 商户号 userNo M Number GEP提供给商户的唯一编号
02. 卡唯一编号 cardId O String 卡唯一编号
03. 卡号 cardNo M String 卡号
04. 卡安全验证码CVV(3位) cardVerifyNo M Number 卡安全验证码CVV(3位)
05. 卡别名 cardAlias O String 卡别名
06. 卡标签 cardLabel O String 卡标签
07. 卡有效期 cardExpiryDate M String 卡有效期（格式：yyyyMM，如：202203）
08. 卡本币种 localCurrency M String 卡本币种
09. 卡当前额度 creditLimitAmt O Number 卡当前额度（共享卡可能不能存在或者0）
10. 卡余额 balanceAmt M Number 卡余额
11. 已使用授权额度 usedAuthAmt M Number 已用额度
12. 卡日限额 dailyLimitAmount C Number 共享-附属卡日限额,附属卡返回
13. 销卡金额 cardClosedAmt C Number 销卡金额，销卡状态下有值（针对常模式）
14. 卡状态 cardStatus M String 1：使用中
2：已销卡
0：冻结
15. 卡状态描述 cardStatusDesc M String
16. 卡片生成时间 createTime M String 卡片生成时间,格式：yyyy-MM-dd HH:mm:ss
17. 子用户号 subUserNo O String 子用户号（主用户不返回）
18. 子用户名 subUserName O String 子用户名（主用户不返回）

result示例

{
    "currentPage": 1,
    "list": [
        {
            "balanceAmt": "100.00",
            "cardAlias": "api2测试",
            "cardExpiryDate": "203011",
            "cardId": "2601081603000002279",
            "cardLabel": "",
            "cardNo": "4383570047247615",
            "cardStatus": "1",
            "cardStatusDesc": "使用中",
            "cardVerifyNo": "755",
            "createTime": "2026-01-08 16:03:55",
            "creditLimitAmt": "0.00",
            "dailyLimitAmount": "10.00",
            "localCurrency": "USD",
            "usedAuthAmt": "0.00",
            "userNo": "5181210831000233268"
        },
        {
            "balanceAmt": "100.00",
            "cardAlias": "api2测试",
            "cardExpiryDate": "203009",
            "cardId": "2601061814000002259",
            "cardLabel": "",
            "cardNo": "4383570035475889",
            "cardStatus": "1",
            "cardStatusDesc": "使用中",
            "cardVerifyNo": "537",
            "createTime": "2026-01-06 18:14:57",
            "creditLimitAmt": "500.00",
            "dailyLimitAmount": "16.00",
            "localCurrency": "USD",
            "usedAuthAmt": "0.00",
            "userNo": "5181210831000233268"
        },
        {
            "balanceAmt": "100.00",
            "cardAlias": "api测试",
            "cardExpiryDate": "202603",
            "cardId": "2601061813000002258",
            "cardLabel": "",
            "cardNo": "4383570025408767",
            "cardStatus": "1",
            "cardStatusDesc": "使用中",
            "cardVerifyNo": "098",
            "createTime": "2026-01-06 18:13:46",
            "creditLimitAmt": "0.00",
            "dailyLimitAmount": "9.00",
            "localCurrency": "USD",
            "usedAuthAmt": "0.00",
            "userNo": "5181210831000233268"
        },
        {
            "balanceAmt": "100.00",
            "cardAlias": "api2测试",
            "cardExpiryDate": "203005",
            "cardId": "2601061810000002257",
            "cardLabel": "",
            "cardNo": "4383570033282915",
            "cardStatus": "1",
            "cardStatusDesc": "使用中",
            "cardVerifyNo": "221",
            "createTime": "2026-01-06 18:10:31",
            "creditLimitAmt": "0.00",
            "dailyLimitAmount": "15.00",
            "localCurrency": "USD",
            "usedAuthAmt": "0.00",
            "userNo": "5181210831000233268"
        }

    ],
    "pageSize": 10,
    "totalCount": "4",
    "totalPages": 1,
    "userNo": "5181210831000233268"
}