微信-微信退款（三）

最新推荐文章于 2024-08-11 03:33:26 发布
最新推荐文章于 2024-08-11 03:33:26 发布
阅读量2.8k 收藏 1
点赞数 2
分类专栏： 微信；小程序 文章标签： 微信
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/MinggeQingchun/article/details/129822161
版权

一、微信申请退款

微信支付退款 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，则商户平台上配置的回调地址将不会生效。

举例如下：

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <mch_id>10000100</mch_id>
   <nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
   <out_refund_no>1415701182</out_refund_no>
   <out_trade_no>1415757673</out_trade_no>
   <refund_fee>1</refund_fee>
   <total_fee>1</total_fee>
   <transaction_id>4006252001201705123297353072</transaction_id>
   <sign>FE56DD4AA85C0EECA82C35595A69E153</sign>
</xml>

返回结果

字段名变量名必填类型示例值描述
返回状态码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开始编号

举例如下：

<xml>
   <return_code><![CDATA[SUCCESS]]></return_code>
   <return_msg><![CDATA[OK]]></return_msg>
   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
   <mch_id><![CDATA[10000100]]></mch_id>
   <nonce_str><![CDATA[NfsMFbUFpdbEhPXP]]></nonce_str>
   <sign><![CDATA[B7274EB9F8925EB93100DD2085FA56C0]]></sign>
   <result_code><![CDATA[SUCCESS]]></result_code>
   <transaction_id><![CDATA[4008450740201411110005820873]]></transaction_id>
   <out_trade_no><![CDATA[1415757673]]></out_trade_no>
   <out_refund_no><![CDATA[1415701182]]></out_refund_no>
   <refund_id><![CDATA[2008450740201411110000174436]]></refund_id>
   <refund_fee>1</refund_fee>
</xml>

错误码

名称描述原因解决方案
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) 与微信支付订单总金额不一致
退款请求

 <xml>
  <sign>464fd80d3822f288396c321501a06c29</sign>
  <refund_fee>21500</refund_fee>
  <mch_id>123</mch_id>
  <op_user_id>1232846202</op_user_id>
  <total_fee>21500</total_fee> --这里必须是支付时候的总就价格，特别是分批次退款的时候注意这里
  <appid>123123123123</appid>
  <out_refund_no>20160601195633930</out_refund_no>
  <out_trade_no>2016053017063826030</out_trade_no>
  <nonce_str>nNlsPAcmpP</nonce_str>
</xml>  

退款响应

<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[123123123123]]></appid>
<mch_id><![CDATA[123]]></mch_id>
<nonce_str><![CDATA[F8bnSKUY7qvEpQtk]]></nonce_str>
<sign><![CDATA[908963603B666ECB7FC0F0AE1C1F22EA]]></sign>
<result_code><![CDATA[FAIL]]></result_code>
<err_code><![CDATA[REFUND_FEE_MISMATCH]]></err_code>
<err_code_des><![CDATA[同一个out_refund_no退款金额要一致]]></err_code_des>
</xml>
  • 退款金额 (refund_fee) 大于总金额 (total_fee)
<xml><return_code><![CDATA[FAIL]]></return_code>  
<return_msg><![CDATA[invalid refund_fee]]></return_msg>  
</xml>
  • 订单的支付金额已经全部退款
<xml><return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[123123123123]]></appid>
<mch_id><![CDATA[123]]></mch_id>
<nonce_str><![CDATA[UdhYGRO1wLNkR0TR]]></nonce_str>
<sign><![CDATA[3FD2B2A28ECF24565CA35FCB76149431]]></sign>
<result_code><![CDATA[FAIL]]></result_code>
<err_code><![CDATA[TRADE_STATE_ERROR]]></err_code>
<err_code_des><![CDATA[订单状态错误]]></err_code_des>
</xml>
  • 缺少证书
wx sendpost exception  
org.apache.http.NoHttpResponseException: api.mch.weixin.qq.com:443 failed to respond

微信支付签名验证失败：

1：检查配置信息是否正确

2：检查签名的参数是否齐全

2：检查签名时是否按照参数名 ASCII 字典序排序

3：重新设置下 API 密钥 / 商户平台重新设置客户密钥

4：body 中文换英文

MinggeQingchun
关注
专栏目录
微信退款
祈忘感的博客
04-09 388
我做的退款用的easywechat扩展包做的1.composer下载：composer require "overtrue/laravel-wechat:~3.0"2.将退款封装在model里：  
微信退款操作
weixin_42595331的博客
01-06 705
@ApiOperation(value = "确认并退款", notes = "确认并退款") @PutMapping(value = "/updateAfter/{refundId}") @ApiImplicitParams({@ApiImplicitParam(name = "ACCESS_TOKEN", value = "接口调用凭证", defaultValue = "0...
php api 微信支付,PHP实现微信支付(jsapi支付)和退款(无需集成支付SDK)流程教程详解...
weixin_39695954的博客
03-09 283
之前有写过几篇文章将微信支付和退款：这几篇都是使用了微信官方给的PHP版本的SDK，进行支付的时候写代码可以省不少事，步骤也挺简化，但是集成SDK有很多坑，很多人说引入的SDK老报错，或者说官方SDK本身有不少错误，改起来很麻烦，也确实挺麻烦的，对于新手搞支付很容易被绕进去，那么今天就来讲讲不集成支付SDK直接调用支付接口实现支付和退款。前期准备：1.当然了，还是要有一个微信认证服务号，并且开通了...
微信支付退款接口
12-02
最近在公司商城里边加上了微信支付退款，调用微信支付的退款接口，可以将扫码支付或者公众号支付的订单进行原路退款，亲测可用，小伙伴们不明白的可以问我
微信java 对接退款接口
最新发布
weixin_40787179的博客
08-11 73
微信Java对接退款接口 在商业环境中，退款是经常出现的需求。为了方便商户与客户之间的交易处理，微信提供了一整套的API，包括退款接口。本文将介绍如何在Java中对接微信的退款接口，并提供相关的代码示例。 微信退款接口简介 微信支付的退款接口允许商户在订单出现问题时，及时处理客户的退款请求。通过调用退款接口，商户可以将金额...
微信订单退款接口
weixin_41201496的博客
08-04 479
//退款 public static function tui($transaction_id,$tui_no,$order_money,$money){ $param = [ 'appid' => Config::get('app.appid'), 'mch_id' => Config::get('app.mch_id'), //商户id 'nonce_str' => self::getRan
支付宝退款微信退款接口实现
casey的博客
08-21 314
支付宝退款微信退款接口实现
微信退款和支付宝退款接口调用(java版)
三人行，必有我师焉。
08-23 3906
项目中需要使用到微信和支付宝的退款功能，在这两天研究了一下这两个平台的退款，有很多坑，在开发中需要留意  1、微信退款接口  相对来说我感觉微信的退款接口还是比较好调用的，直接发送httppost请求即可； /** * * @方法名称:payRefund * @内容摘要: ＜退款＞ * @param transaction_id *
java微信退款（支持部分退款）
02-06
亲测，需要注意的地方在博客中有：http://blog.csdn.net/goligory/article/details/79274416
2023-JAVA微信支付-工具类，包含微信退款，微信支付，微信相关V2版本V3接口集成
05-10
内容：微信支付-工具类，包含微信退款，微信支付，微信相关V2版本V3接口集成 适用人群：JAVA 使用场景：集成好微信支付，可自由调整相关类，自由编写业务场景 说明： 将工具类导入该自行项目，将maven-jar 的配置...
微信小程序-微信支付和微信退款（Java后台）
12-22
微信支付流程 都是我自己工作中开发的，亲测可用，不喜勿喷。 controller中我是这么写的，你们需要根据自己的业务需求改动。ResponseBean是我自己封装的，你们可以改成你们想要的形式。` /** * 微信统一下单接口 ...
基于node.js实现微信支付退款功能
10-18
在微信开发中有有付款就会有退款，这样的功能非常常见，这篇文章主要介绍了node.js实现微信支付退款功能,需要的朋友可以参考下
Java后台实现微信支付和微信退款
08-19
"Java后台实现微信支付和微信退款" 本资源主要介绍了Java后台实现微信支付和微信退款的详细过程，通过示例代码对微信支付流程进行了详细的讲解，对大家的学习或者工作具有一定的参考学习价值。 知识点1：微信支付...
微信-支付宝支付Demo.rar
06-10
综上所述，"微信-支付宝支付Demo.rar"是一个非常实用的资源，它可以帮助开发者快速理解和实现微信和支付宝的支付功能，包括H5支付、扫码付（主扫、被扫）以及退款操作，是.NET开发者在移动支付领域不可多得的学习和...
微信小程序支付接口退款接口（后端node）
weixin_44132829的博客
06-21 3516
来讲讲微信支付吧，看到微信官方文档里好像没有node写的库和sdk，就去百度，然后看到有个哔哩哔哩视频教程。怕以后找不到了就写个博客记录一下，如有问题或者有侵权请及时联系。 哔哩哔哩视频链接： https://www.bilibili.com/video/BV1mE411w73k?p=3&spm_id_from=pageDriver //微信官方文档 https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPay
微信申请退款API~~开发
热门推荐
xiaozhegaa的博客
10-16 6万+
近日，在开发“微信申请退款”的功能。之前有过微信开发的经验，但是第一次接触“微信退款“这一块的业务，查询了很多的博客资料以及走了很多的弯路。也发现“微信退款”分享的博客并不多。特地写了该博客，希望对你们有帮助。个人浅薄的见解 【稍微提一下：】上一篇博客分享了“企业付款到银行卡API~~”文章，有位博友留言了，遇到了“产品权限验证失败 请查看您当前是否具有该产品的权限”。这是因为没有在微信商务后
2008服务器做微信退款,Net微信退款开发流程
weixin_42297605的博客
08-06 156
最近做了关于微信退款的后台SDK集成开发，这里做下记录。1.微信提供了C#版本的SDK，可以直接拿过来用，而不用自己去对照着微信api开发文档去自己写SDK。2.这里需要注意下，微信开放平台的账号是一个总的账号，它可以绑定微信公众号、微信APP支付等多个应用 这里的每个应用都会有一个自己对应的商户号，而在对应的商户后台，每个商户的证书也是需要单独下载的。意思就是说，即使是同一个开放平台的账号，绑...
微信支付 APP端 第三弹 申请退款
Little___Turtle的博客
06-29 975
第三弹 微信申请退款 简单有用版
nodejs实现微信小程序的退款
Tirst_的博客
07-08 810
nodejs实现微信小程序的退款及服务号消息通知申请退款双向证书的认证post请求微信接口（个别参数获取方式）随机字符串生成签名退款成功 申请退款 微信小程序退款参考资料 申请退款，简单的流程也来拉出来溜溜 ，毕竟自己写的比文档稍微条理清楚，哈哈哈！来自小仙女魔性的笑???? 双向证书的认证 我们这边不是php环境。所以只需要一个证书就好（p12格式） 按照以下路径下载：微信商户平台(pay.weixin.qq.com)–>账户中心–>账户设置–>API安全 post请求微信接口（个别参数
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值