凭据变动请求

受理侧企业变更凭据，受理侧企业通知慧收钱平台。

接口说明

接口说明

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

业务流程：

  1. 受理侧企业向慧收钱平台发起凭证状态变动请求。
  2. 慧收钱平台同步应答受理侧企业。

公共请求参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32是 ENTERPRISE_PAY_BILL_UPDATE
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] 否 签名数据

业务请求参数

变量 参数名 类型 类型[长度限制] 描述
transNo 商户交易号 string[1,32] 是 商户系统内部服务订单号（不是交易单号），要求32个字符内，且在同一个商户号下唯一
requestDate 交易时间 string[1,14] 是 请求时间，与当前系统时间相差小于10分钟
格式[yyyyMMddHHmmss]
示例值：20190101140908
billList 凭据列表 array 是 每次请求凭据数量为1个， 详见：【凭据列表】
billStatus 凭据变更类型 string[1,20] 是 01：凭据作废
02：额度增加
03：额度减少
04：凭据有效期
05：补充凭据持有人证件信息
billChgAmount 凭据变动额度 string[1,11] 否 单位：分
billStatus 为 02 或 03 时必填
billValidBegin 凭据开始日期 string[1,10] 否 bi1lStatus为04时必填，凭据开始日期不可变更
格式：YYYYMMDD
billValidUntil 凭据结束日期 string[1,10] 否 billStatus 为 04 时必填
格式：YYYYMMDD
billOwnerCertifTp 凭据持有人证件类型 string[1,2] 是 billStatus 为 05 时必填，其他情况不得填写
billOwnerCertifId 凭据持有人证件号码 string[1,20] 是 需要加密传输
billStatus 为 05，其他情况不得填写
reqReserved 请求预留字段 string[1,512] 否 json格式
merchantKey 敏感信息加密秘钥 string[1,255] 否 商户生成随机aes加密秘钥用于对敏感信息加密。 aes加密秘钥需用平台公钥加密传输，平台接收到该参数后解密该字段，用于对敏感信息解密

凭据列表：billList

字段 说明 类型 条件 备注
billId 凭据 ID 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] 否 响应验签数据

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
transNo 商户交易流水号 string[1,32] 是 1234323JKHDFE1243252
tradeNo 慧收钱交易号 string[1,32] 否 1234323JKHDFE1243252 订单创建成功时返回
orderStatus 交易状态 string[1,16] 是 详见交易状态码
billList 返回数据 array 是 -

凭证列表：billList

变量 参数名 类型[长度限制] 必填 描述
billId 凭据 ID string[1,50] 是 -
billTokenId 凭据标记 string[1,50] 是 每笔凭据都将利用银联标记化技术生成唯一对应的凭据标记
tokenCVN2 Token安全码 string[1,3] 否 Token CVN2
tkEndExpr Token有效期 string[1,4] 否 格式：YYMM

交易状态码

枚举值 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败
作者：xiaochen  创建时间：2025-03-07 09:51
最后编辑：xiaochen  更新时间：2025-04-24 10:42