凭据创建结果通知
平台对凭据申请请求处理完成后,通知受理侧企业凭据申请结果。
接口说明
- 通知地址:商户后台通知地址。
- 请求方式:POST
业务流程:
- 慧收钱平台调用此接口向受理侧企业发起凭据申请结果通知。
- 受理侧企业处理申请结果。
通知规则
- 商户收到服务端通知后需返回字符串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
最后编辑:xiaochen 更新时间:2025-04-18 21:29