凭据列表查询

受理侧企业可主动使用本接口向平台查询用户的凭据数据，根据返回的数据同步。

接口说明

  • 测试请求URL：
  • 生产请求URL：
  • 请求方式：POST

业务流程：

  1. 受理侧企业向平台查询用户凭据数据。
  2. 平台同步应答受理侧企业。

公共请求参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32]是 ENTERPRISE_PAY_BILL_LIST_QUERY
version 版本 string[1,16] 是 接口版本：1.0
format 请求格式 string[1,16] 是 业务请求参数格式，支持：JSON
merchantNo 商户号 string[1,16] 是 商户在慧收钱的商户号，由慧收钱生成并下发
signType 加密类型 string[1,16] 是 RSA2:签名机制查看说明
signContent 业务数据 string 是 业务请求参数
sign 签名数据 string[1,256] 否 签名数据

业务请求参数

变量 参数名 类型[长度限制] 必填 描述
billTokenId 凭据标记 string[1,50] 是 凭据标记
nextPageId 分页标识 string[1,10] 否 请求下一页时上送，从上一页应答中获取
usrId 用户编号 string[1,50] 否 当查询具体用户持有的凭据时须上送，为凭据创建请求的凭据持有人
ID

公共响应参数

变量 参数名 类型[长度限制] 必填 描述
success 响应状态 string[1,32] 是 服务端响应状态，如果为true，则可以调用result；如果为false，则调用errorCode来获取出错信息
errorCode 错误码 string[1,32] 否 响应码
errorMsg 错误描述 string[1,128] 否 响应描述
result 响应内容 string 否 业务响应参数
sign 签名数据 string[1,256] 否 响应验签数据

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
totleNum 总笔数 string[1,32] 否 总笔数
nextPageId 分页标识 string[1,32] 否 分页标识
billQueryList 返回数据 string[1,2048] 否 详见：【凭证列表】
respCode 错误码 string[1,32] 否 错误码
respMsg 错误信息 string[1,128] 否 错误信息

凭证列表：billQueryList

变量 参数名 类型[长度限制] 必填 描述
billId 凭据 ID string[1,50] 是 每个凭据对应的唯一编号
billTokenId 凭据标记 string[1,50] 是 每笔凭据都将利用银联标记化技术生成唯一对应的凭据标记
tokenInfoURL Token信息 URL string[1,512] 否 绑定跳转链接，商户可进行画码，使用云闪付app扫码绑定
tokenCVN2 Token安全码 string[1,3] 否 Token CVN2
tkEndExpr Token有效期 string[1,4] 否 格式：YYMM
billType 凭据类型 string[1,50] 是 凭据类型
billOwnerId 凭据持有人ID string[1,50] 是 凭据持有人ID
billOwnerNm 凭据持有人姓名 string[1,32] 是 凭据持有人姓名
billOwnerMobileNo 凭据持有人手机号 string[1,20] 是 凭据持有人手机号
billOwnerCertifTp 凭据持有人证件类型 string[1,20] 否 01：身份证
02：军官证
03：护照
04：港澳居民来往内地通行证（回乡证）
05：台湾同胞来往内地通行证（台胞证）
06：警官证
07：士兵证
08：户口簿
09：临时身份证
10：外国人居留证
12：港澳居民居住证
13：台湾居民居住证
99：其他证件
billOwnerCertifId 凭据持有人证件号码 string[1,20] 否 对应证件类型的证件号码
billBalance 凭据生命周期限额 string[1,20] 是 凭据生命周期限额
billValidBegin 凭据开始日期 string[1,10] 是 格式：YYYYMMDD
billValidUntil 凭据结束日期 string[1,10] 是 格式：YYYYMMDD
billRemainTimes 凭据剩余可用次数 string[1,3] 否 凭据剩余可用次数
billSingleLimit 凭据单笔限额 string[1,11] 否 该字段若为空则不限制凭据单笔使用额度
作者：yuzuqiang  创建时间：2025-04-18 20:36
最后编辑：yuzuqiang  更新时间：2025-05-29 18:12