凭据创建结果通知

平台对凭据申请请求处理完成后,通知受理侧企业凭据申请结果。


接口说明

  • 通知地址:商户后台通知地址。
  • 请求方式:POST

业务流程:

  1. 慧收钱平台调用此接口向受理侧企业发起凭据申请结果通知。
  2. 受理侧企业处理申请结果。

通知规则

  • 商户收到服务端通知后需返回字符串SUCCESS,如果未收到应答或未按要求返回,则视为通知失败,系统会重新发起通知,尽可能提高通知的成功率,通知频率为0s/3s/5s/10s/15s/60s/3m/10m/30m/60m/3h/6h/6h,如果还通知失败,可调用查询订单API查询结果。

公共通知参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] CALLBACK_BILL_CREATE
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] 1234323JKHDFE1243252
tradeNo 慧收钱交易号 string[1,32] 慧收钱交易号
orderStatus 交易状态 string[1,16] 交易状态,详见交易状态码
respCode 错误码 string[1,32]
respMsg 错误信息 string[1,128]
billList 凭据列表 array

凭据列表:billList

变量 参数名 类型[长度限制] 必填 描述
billId 凭据 ID string[1,50] -
billOwnerId 凭据持有人 ID string[1,50] -
billTokenId 凭据标记 string[1,50] -
tokenInfoURL Token信息 URL string[1,512] -
tokenCVN2 Token安全码 string[1,3] -
tkEndExpr Token有效期 string[1,4] -

交易状态码

枚举值 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败
作者:xiaochen  创建时间:2025-03-25 19:30
最后编辑:xiaochen  更新时间:2025-04-18 21:29