订单支付状态改变后,慧收钱会把支付结果通知给商户。
接口说明
通知地址:收单API上送的后台通知地址。
通知方式:POST
通知规则
商户收到服务端通知后需返回字符串SUCCESS,如果未收到应答或未按要求返回,则视为通知失败,系统会重新发起通知,尽可能提高通知的成功率,通知频率为0s/3s/5s/10s/15s/60s/3m/10m/30m/60m/3h/6h/6h ,如果还通知失败,可调用查询订单API查询结果。
公共通知参数
变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
method | 方法名 | string[1,32] | 是 | CALLBACK |
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,128] | 否 | 签名数据 |
业务参数
变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
transNo | 商户订单号 | string[1,64] | 是 | 原支付交易对应的商户订单号 |
tradeNo | 交易订单号 | string[1,32] | 是 | 慧收钱系统交易订单号 |
orderAmt | 交易金额 | string[1,16] | 是 | 交易金额,单位:分 |
orderStatus | 交易状态 | string[1,16] | 是 | 交易状态,详见交易状态码 |
finishedDate | 完成时间 | string[1,14] | 否 | 交易完成时间,格式[yyyyMMddHHmmss] 示例:20190101140908 |
respCode | 响应码 | string[1,32] | 是 | 详见交易响应码 |
respMsg | 响应描述 | string[1,128] | 是 | 详见交易响应码 |
requestDate | 请求时间 | string[1,14] | 是 | 交易请求时间,格式[yyyyMMddHHmmss] 示例:20190101140908 |
payOrderNo | B2b支付订单号 | string[1,64] | 否 | B2b支付生成的订单号 |
extend | 附加字段 | string[1,128] | 否 | 附加数据,原样返回 |
memo | 扩展信息 | string[1,512] | 否 | json格式,将如下参数转json |
公共通知示例
{method=CALLBACK, format=json, signType=RSA2, signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=814000473149}
应答参数
客户端在正常接收服务端通知报文同步响应“SUCCESS”来结束此流程。
交易状态码
状态码 | 描述 |
---|---|
INIT | 初始化 |
PROCESSING | 处理中 |
SUCCESS | 成功 |
FAIL | 失败 |
交易响应码
响应码 | 描述 | 解决方案 |
---|---|---|
200004 | 订单不存在 | |
200007 | 查询成功 | |
200008 | 查询失败 | |
200009 | 查询结果集为空 |
作者:xiaochen 创建时间:2025-03-20 15:20
最后编辑:xiaochen 更新时间:2025-03-20 15:29
最后编辑:xiaochen 更新时间:2025-03-20 15:29