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

接口说明

通知地址：申请退款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] 是 退款请求的商户订单号
origTransNo 原商户订单号 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] 是 详见交易响应码
extend 附加字段 string[1,128] 否 附加数据，原样返回

公共通知示例

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

业务示例

{
"extend":"自定义参数",
"finishedDate":"",
"orderAmt":"1",
"orderStatus":"SUCCESS",
"origTransNo":"DD20210812102555029",
"respCode":"000000",
"respMsg":"交易成功",
"tradeNo":"12000020210812102438004012382163",
"transNo":"DD20210812103012841"
}

应答参数

客户端在正常接收服务端通知报文同步响应“SUCCESS”来结束此流程。

交易状态码

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

交易响应码

响应码 描述 解决方案
100015 渠道不支持退款
100016 渠道不支持部分退款
100508 退款金额大于可退金额
500001 原单订单状态不为成功
500002 退款金额大于可退金额
500003 原订单不存在
200999 退回商户余额成功
作者：xiaochen  创建时间：2024-11-29 17:28
最后编辑：xiaochen  更新时间：2025-06-12 09:32