退款订单状态改变后，慧收钱会把退款结果通知给商户。

接口说明

通知地址：申请退款接口上送的后台通知地址。

通知方式：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] 是 退款请求的商户订单号
origTransNo 原商户订单号 string[1,64] 是 原支付交易对应的商户订单号
tradeNo 交易订单号 string[1,32] 是 慧收钱系统交易订单号
orderAmt 退款金额 string[1,16] 是 退款金额，单位：分
orderStatus 退款状态 string[1,16] 是 退款状态，详见交易状态码
requestDate 请求时间 string[1,14] 是 交易请求时间，格式[yyyyMMddHHmmss]
示例：20190101140908
finishedDate 完成时间 string[1,14] 否 退款完成时间，格式[yyyyMMddHHmmss]
示例：20190101140908
respCode 响应码 string[1,32] 是 详见交易响应码
respMsg 响应描述 string[1,128] 是 详见交易响应码
extend 附加字段 string[1,128] 否 附加数据，原样返回

公共通知示例

{method=CALLBACK, format=json, signType=RSA2, signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=814000473149}

业务通知示例

{method=CALLBACK, format=json, sign=10a6203bdefb8e6ec173c954c5d60c22163cfcdcbd71036aec9450d4f6fdc4550d8bd438fbe7570576c9fc29f198abed4c8a3daa0e3ba2fff51fe4402f519eb9d467eabf3219ec5feb44c0004cc85082bc1bb6163ec41119c073cb35e936a1fda85178501e734d4b0b05f3653bd1cc6de4a62a6a6ce8518a82af63bc83fa1b9ae02ed29e917b25c0a078042b109275f31d7d985012fdf2a11a22ffeeaf806eb096110eb961416c2da3bcdd23fb9ce7c1939d19baa65b47f61eb10bb24a65f58021b973f215acfc6b7fa14f1ea9fc3d2df1f343414d40dcf131fa296a16b5726a9f729144a50512d5e3eae90df38e1e5715d0fdad6c47f965ee9a80d25a8e58ff, signType=RSA2, signContent={"bizOrderNo":"","finishedDate":"20241210130815","memo":"{\"shareRefundAdvanceFlag\":\"0\"}","orderAmt":"1","orderStatus":"SUCCESS","origTransNo":"202412101306234766303895","requestDate":"20241210130810","respCode":"000000","respMsg":"交易成功","tradeNo":"12010120241210130811900433869651","transNo":"202412101308105884190140"}, version=1.0.0, merchantNo=841508774642}

交易状态码

状态码 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败

交易响应码

响应码 描述 解决方案
200004 订单不存在
200007 查询成功
200008 查询失败
200009 查询结果集为空
作者：xiaochen  创建时间：2025-03-20 15:20
最后编辑：xiaochen  更新时间：2025-03-20 15:29