一、微信申请退款
微信支付退款 API 地址
https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_4&index=6
应用场景
当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家账号上。
注意：
1、交易时间超过一年的订单无法提交退款；
2、微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号。
3、请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次
错误或无效请求频率限制：6qps，即每秒钟异常或错误的退款申请请求不超过6次
4、每个支付订单的部分退款次数不能超过50次
5、如果同一个用户有多笔退款，建议分不同批次进行退款，避免并发退款导致退款失败
6、申请退款接口的返回仅代表业务的受理情况，具体退款是否成功，需要通过退款查询接口获取结果。
7、一个月之前的订单申请退款频率限制为：5000/min
8、同一笔订单多次退款的请求需相隔1分钟
状态机
退款状态转变如下：
接口地址
接口链接：https://api.mch.weixin.qq.com/secapi/pay/refund
是否需要证书
请求需要双向证书。 详见证书使用
请求参数
字段名变量名必填类型示例值描述公众账号IDappid是String(32)wx8888888888888888微信分配的公众账号ID（企业号corpid即为此appId）商户号mch_id是String(32)1900000109微信支付分配的商户号随机字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串，不长于32位。推荐随机数生成算法签名sign是String(32)C380BEC2BFD727A4B6845133519F3AD6签名，详见签名生成算法签名类型sign_type否String(32)HMAC-SHA256签名类型，目前支持HMAC-SHA256和MD5，默认为MD5微信支付订单号transaction_id二选一String(32)1217752501201407033233368018微信生成的订单号，在支付通知中有返回商户订单号out_trade_noString(32)1217752501201407033233368018商户系统内部订单号，要求32个字符内（最少6个字符），只能是数字、大小写字母_-|*且在同一个商户号下唯一。详见商户订单号 transaction_id、out_trade_no二选一，如果同时存在优先级：transaction_id> out_trade_no
商户退款单号out_refund_no是String(64)1217752501201407033233368018商户系统内部的退款单号，商户系统内部唯一，只能是数字、大小写字母_-|*@ ，同一退款单号多次请求只退一笔。订单金额total_fee是int100订单总金额，单位为分，只能为整数，详见支付金额退款金额refund_fee是int100退款总金额，订单总金额，单位为分，只能为整数，详见支付金额退款货币种类refund_fee_type否String(8)CNY退款货币类型，需与支付一致，或者不填。符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型退款原因refund_desc否String(80)商品已售完 若商户传入，会在下发给用户的退款消息中体现退款原因
注意：若订单退款金额≤1元，且属于部分退款，则不会在退款消息中体现退款原因
退款资金来源refund_account否String(30)REFUND_SOURCE_RECHARGE_FUNDS 仅针对老资金流商户使用
REFUND_SOURCE_UNSETTLED_FUNDS---未结算资金退款（默认使用未结算资金退款）
REFUND_SOURCE_RECHARGE_FUNDS---可用余额退款
退款结果通知urlnotify_url否String(256)https://weixin.qq.com/notify/ 异步接收微信支付退款结果通知的回调地址，通知URL必须为外网可访问的url，不允许带参数
公网域名必须为https，如果是走专线接入，使用专线NAT IP或者私有回调域名可使用http。
如果参数中传了notify_url，则商户平台上配置的回调地址将不会生效。
举例如下：
返回结果
字段名变量名必填类型示例值描述返回状态码return_code是String(16)SUCCESSSUCCESS/FAIL返回信息return_msg否String(128)签名失败 返回信息，如非空，为错误原因
签名失败
参数格式校验错误
以下字段在return_code为SUCCESS的时候有返回
字段名变量名必填类型示例值描述业务结果result_code是String(16)SUCCESS SUCCESS/FAIL
SUCCESS退款申请接收成功，结果通过退款查询接口查询
FAIL 提交业务失败
错误代码err_code否String(32)SYSTEMERROR列表详见错误码列表错误代码描述err_code_des否String(128)系统超时结果信息描述公众账号IDappid是String(32)wx8888888888888888微信分配的公众账号ID商户号mch_id是String(32)1900000109微信支付分配的商户号随机字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串，不长于32位签名sign是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS签名，详见签名算法微信支付订单号transaction_id是String(32)4007752501201407033233368018微信订单号商户订单号out_trade_no是String(32)33368018商户系统内部订单号，要求32个字符内（最少6个字符），只能是数字、大小写字母_-|*且在同一个商户号下唯一。详见商户订单号商户退款单号out_refund_no是String(64)121775250商户系统内部的退款单号，商户系统内部唯一，只能是数字、大小写字母_-|*@ ，同一退款单号多次请求只退一笔。微信退款单号refund_id是String(32)2007752501201407033233368018微信退款单号退款金额refund_fee是int100退款总金额,单位为分,可以做部分退款应结退款金额settlement_refund_fee否int100去掉非充值代金券退款金额后的退款金额，退款金额=申请退款金额-非充值代金券退款金额，退款金额<=申请退款金额标价金额total_fee是int100订单总金额，单位为分，只能为整数，详见支付金额应结订单金额settlement_total_fee否int100去掉非充值代金券金额后的订单总金额，应结订单金额=订单金额-非充值代金券金额，应结订单金额<=订单金额。标价币种fee_type否String(8)CNY订单金额货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型现金支付金额cash_fee是int100现金支付金额，单位为分，只能为整数，详见支付金额现金支付币种cash_fee_type否String(16)CNY货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型现金退款金额cash_refund_fee否int100现金退款金额，单位为分，只能为整数，详见支付金额代金券类型coupon_type_$n否String(8)CASH CASH--充值代金券
NO_CASH---非充值代金券
订单使用代金券时有返回（取值：CASH、NO_CASH）。$n为下标,从0开始编号，举例：coupon_type_0
代金券退款总金额coupon_refund_fee否int100代金券退款金额<=退款金额，退款金额-代金券或立减优惠退款金额为现金，说明详见代金券或立减优惠单个代金券退款金额coupon_refund_fee_$n否int100代金券退款金额<=退款金额，退款金额-代金券或立减优惠退款金额为现金，说明详见代金券或立减优惠退款代金券使用数量coupon_refund_count否int1退款代金券使用数量退款代金券IDcoupon_refund_id_$n否String(20)10000 退款代金券ID, $n为下标，从0开始编号
举例如下：
错误码
名称描述原因解决方案SYSTEMERROR接口返回错误系统超时等请不要更换商户退款单号，请使用相同参数再次调用API。BIZERR_NEED_RETRY退款业务流程错误，需要商户触发重试来解决并发情况下，业务被拒绝，商户重试即可解决请不要更换商户退款单号，请使用相同参数再次调用API。TRADE_OVERDUE订单已经超过退款期限订单已经超过可退款的最大期限(支付后一年内可退款)请选择其他方式自行退款ERROR业务错误申请退款业务发生错误该错误都会返回具体的错误原因，请根据实际返回做相应处理。USER_ACCOUNT_ABNORMAL退款请求失败用户账号注销此状态代表退款申请失败，商户可自行处理退款。INVALID_REQ_TOO_MUCH无效请求过多连续错误请求数过多被系统短暂屏蔽请检查业务是否正常，确认业务正常后请在1分钟后再来重试NOTENOUGH余额不足商户可用退款余额不足此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理。INVALID_TRANSACTIONID无效transaction_id请求参数未按指引进行填写请求参数错误，检查原交易号是否存在或发起支付交易接口返回失败PARAM_ERROR参数错误请求参数未按指引进行填写请求参数错误，请重新检查再调用退款申请APPID_NOT_EXISTAPPID不存在参数中缺少APPID请检查APPID是否正确MCHID_NOT_EXISTMCHID不存在参数中缺少MCHID请检查MCHID是否正确ORDERNOTEXIST订单号不存在缺少有效的订单号请检查你的订单号是否正确且是否已支付，未支付的订单不能发起退款REQUIRE_POST_METHOD请使用post方法未使用post传递参数 请检查请求参数是否通过post方法提交SIGNERROR签名错误参数签名结果不正确请检查签名参数和方法是否都符合签名算法要求XML_FORMAT_ERRORXML格式错误XML格式错误请检查XML参数格式是否正确FREQUENCY_LIMITED频率限制1个月之前的订单申请退款有频率限制该笔退款未受理，请降低频率后重试NOAUTH异常IP请求不予受理请求ip异常如果是动态ip，请登录商户平台后台关闭ip安全配置； 如果是静态ip，请确认商户平台配置的请求ip 在不在配的ip列表里 CERT_ERROR证书校验错误请检查证书是否正确，证书是否过期或作废。请检查证书是否正确，证书是否过期或作废。REFUND_FEE_MISMATCH订单金额或退款金额与之前请求不一致，请核实后再试订单金额或退款金额与之前请求不一致，请核实后再试订单金额或退款金额与之前请求不一致,请核实后再试INVALID_REQUEST请求参数符合参数格式，但不符合业务规则此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理。此状态代表退款申请失败，商户可根据具体的错误提示做相应的处理。ORDER_NOT_READY订单处理中，暂时无法退款，请稍后再试订单处理中，暂时无法退款，请稍后再试 订单处理中，暂时无法退款，请稍后再试
二、微信支付退款报错
注意事项：
total_fee：必须是订单的支付金额，单位：分；refund_fee：少于订单支付金额，单位：分；同一个订单可以发起多次退款，商户退款单号（out_refund_no）可以不同；使用一个商户退款单号（out_refund_no）进行退款，因为某种原因退款失败了，不影响下次使用其他的商户退款单号进行退款 。
部分错误信息
退款中的总金额 (total_fee) 与微信支付订单总金额不一致
退款请求
退款响应
退款金额 (refund_fee) 大于总金额 (total_fee)
订单的支付金额已经全部退款
缺少证书
wx sendpost exception
org.apache.http.NoHttpResponseException: api.mch.weixin.qq.com:443 failed to respond
微信支付签名验证失败：
1：检查配置信息是否正确
2：检查签名的参数是否齐全
2：检查签名时是否按照参数名 ASCII 字典序排序
3：重新设置下 API 密钥 / 商户平台重新设置客户密钥
4：body 中文换英文