请求URL

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

请求参数

加密数据dataContent

序号 域名 变量名 必填 长度 备注
01. 卡唯一编号 cardId M String 卡唯一编号
02. 是否查询持卡人 isQueryCardHolder C boolean true：查询持卡人
false：不查询持卡人。不传默认：false

dataContent示例

{
    "cardId": 2601061507000002248,
    "queryCardHolder": true
}

响应参数

结果信息result

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

cardUserInfo:

域名 变量名 必填 长度 备注
持卡人名字 firstName M String 持卡人姓名中的名字
持卡人姓 lastName M String 持卡人姓名中的姓
邮箱 email M String 持卡人邮箱
手机号 mobile M String 持卡人手机号（如：86-132****）
出生日期 birthDate M String 持卡人的出生日期，格式：yyyy-MM-dd

billAddressInfo:

域名 变量名 必填 长度 备注
账单国家代码 countryCode M String 持卡人账单所属国家代码，可见附录：国家代码
账单国家名称 country M String 国家代码对应的国家名称
账单省份 billingState M String 持卡人账单所属省份
账单城市 billingCity M String 持卡人账单所属城市
账单地址 billingAddress M String 持卡人账单地址详情
账单邮编 billingZipCode M String 持卡人账单地址的邮编

result示例

{
    "balanceAmt": "5.00",
    "billAddressInfo": {
        "billingAddress": "df",
        "billingCity": "df",
        "billingState": "we",
        "billingZipCode": "345678",
        "country": "中国香港",
        "countryCode": "HKG"
    },
    "cardAlias": "api测试",
    "cardExpiryDate": "203005",
    "cardId": "2601061507000002248",
    "cardNo": "4383570012136512",
    "cardStatus": "1",
    "cardStatusDesc": "使用中",
    "cardUserInfo": {
        "birthDate": "1992-05-01",
        "email": "12253876672@qq.com",
        "firstName": "diyie",
        "lastName": "zhang",
        "middleName": "",
        "mobile": "86-12253876672"
    },
    "cardVerifyNo": "310",
    "createTime": "2026-01-06 15:07:45",
    "creditLimitAmt": "5.00",
    "localCurrency": "USD",
    "usedAuthAmt": "0.00",
    "userNo": "5181210831000233268"
}