微信支付 API
  1. API列表
微信支付 API
  • 文档说明
    • 阅读对象
    • 版本说明
  • 术语
    • 支付模式
    • 名词解释
  • 支付账户
    • 支付账户
  • 接口规则
    • 协议规则
    • 参数规定
    • 安全规范
    • 获取openid
  • JSAPI支付
    • 场景介绍
    • 案例介绍
    • 接入前准备
    • 开发指引
    • 获取微信版本号
    • JSAPI调起支付
    • 支付常见问题
  • API列表
    • 统一下单
      POST
    • 查询订单
      POST
    • 关闭订单
      POST
    • 申请退款
      POST
    • 查询退款
      POST
    • 下载交易账单
      POST
    • 下载资金账单
      POST
    • 支付结果通知
      POST
    • 交易保障
      POST
    • 退款结果通知
      POST
  • 最佳实践
    • 支付回调和查单实现指引
    • 支付验收指引
    • 网络排查指引
    • 最佳安全实践
    • 跨城冗灾方案
    • 回调通知注意事项
    • 专线商户Notify升级指引
    • 商户收银台H5大字号规范
    • 微信支付二维码规范
  • 运营规范
    • 运营规范
  • SDK与DEMO下载
    • SDK与DEMO下载
  1. API列表

申请退款

POST
/secapi/pay/refund

应用场景#

当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家账号上。
注意：
1、交易时间超过一年的订单无法提交退款
2、微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号
3、请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次
4、每个支付订单的部分退款次数不能超过50次
5、如果同一个用户有多笔退款，建议分不同批次进行退款，避免并发退款导致退款失败
6、申请退款接口的返回仅代表业务的受理情况，具体退款是否成功，需要通过退款查询接口获取结果。
7、一个月之前的订单申请退款频率限制为：5000/min
8、同一笔订单多次退款的请求需相隔1分钟

状态机#

退款状态转变如下：
img

是否需要证书#

请求需要双向证书。 详见证书使用

错误码#

名称描述原因解决方案
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订单处理中，暂时无法退款，请稍后再试订单处理中，暂时无法退款，请稍后再试订单处理中，暂时无法退款，请稍后再试
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/secapi/pay/refund' \
--header 'Content-Type: application/xml' \
--data-raw '<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>'
响应示例响应示例
<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[1008450740201411110005820873]]></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>

请求参数

Body 参数application/xml

示例

返回响应

🟢200成功
application/json
Body

修改于 2022-07-21 12:23:41
上一页
关闭订单
下一页
查询退款
Built with