应用场景
在押金已消费的情况下,部分金额已结算给商户的资金退还给用户,并为用户下发“退款发起提醒通知“;退款到账后,下发“押金退还到账通知”。可调用多次,允许部分退款;
注意:
交易时间超过一年的订单无法提交退款;退款支持单笔交易分多次退款,多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。一笔退款失败后重新提交,请不要更换退款单号,请使用原商户退款单号。更换退款单号导致多次退款责任由商户承担;请求频率限制:150qps,即每秒钟正常的申请退款请求次数不超过150次;错误或无效请求频率限制:6qps,即每秒钟异常或错误的退款申请请求不超过6次;每个支付订单的部分退款次数不能超过50次;
接口规则
请求Urlhttps://api.mch.weixin.qq.com/deposit/refund
是否需要证书是,详见证书使用
请求方式post
签名方式HMAC-SHA256
请求参数
名称
变量名
必填
类型
示例值
描述
服务商应用IDappid是String(32)wx8888888888888888服务商商户的APPID
商户号mch_id是String(32)1900000109服务商商户的商户号
子商户应用IDsub_appid否String(32)wx8888888888888888微信分配的子商户APPID,如需在支付完成后获取sub_openid则此参数必传。
子商户号sub_mch_id是String(32)1900000109服务商通过进件后获得的特约商户号
随机字符串
nonce_str
是
String(32)
5K8264ILTKCH16CQ2502SI8ZNMTM67VS
随机字符串,不长于32位。推荐随机数生成算法
签名
sign
是
String(32)
C370BEC2BFD727A4B6845133519F3AD6
签名类型
sign_type
是
String(32)
HMAC-SHA256
签名类型,仅支持HMAC-SHA256
微信支付订单号
transacti