微信支付 API
  1. API列表
微信支付 API
  • 文档说明
    • 阅读对象
    • 版本说明
  • 名词表
    • 支付模式
    • 名词解释
    • 参数规定
  • 支付产品
    • 付款码支付
      • 支付账户
      • 场景介绍
      • 验证密码规则
      • 案例介绍
      • 协议规则
      • 开发指引
      • API列表
        • 付款码支付
          POST
        • 查询订单
          POST
        • 撤销订单
          POST
        • 申请退款
          POST
        • 查询退款
          POST
        • 下载交易账单
          POST
        • 下载资金账单
          POST
    • JSAPI支付
      • 支付账户
      • 场景介绍
      • 案例介绍
      • 接入前准备
      • 协议规则
      • 开发指引
      • 获取微信版本号
      • API列表
        • 统一下单
        • 查询订单
        • 关闭订单
        • 申请退款
        • 查询退款
        • 下载交易账单
        • 下载资金账单
    • Native支付
    • APP支付
    • H5支付
    • 小程序支付
  • 接口规则
    • 协议规则
    • 参数规定
    • 安全规范
    • 获取openid
  • API列表
    • 统一下单
    • 查询订单
    • 关闭订单
    • 申请退款
    • 查询退款
    • 下载交易账单
    • 下载资金账单
    • 支付结果通知
    • 交易保障
    • 退款结果通知
  • API安全
    • 最佳安全实践
    • 安全与网络相关注意事项
    • HTTPS服务器配置
  • 最佳实践
    • 支付回调和查单实现指引
    • 回调通知注意事项
    • 专线商户Notify升级指引
    • 支付验收指引
    • 跨城冗灾方案
  • 运营规范
    • 运营规范
  • SDK与DEMO下载
    • SDK与DEMO下载
  1. API列表

申请退款

POST
/secapi/pay/refund

应用场景#

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

状态机#

退款状态转变如下:
img

请求参数

Body 参数application/xml

示例

返回响应

🟢200成功
application/xml
Body

请求示例请求示例
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>
修改于 2025-09-29 09:00:11
上一页
撤销订单
下一页
查询退款
Built with