---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4013071200.md"
title: "常见问题"
doc_id: 4013071200
---

>更新时间：2026.06.24

#### Q：在使用申请退款接口时，能否设置“附加数据”参数？

A：依据微信支付API文档，申请退款接口是不支持设置“附加数据”参数的。

#### Q：在哪些情况下，会显示退款已关闭的状态？

A：退款关闭状态可能由以下情况引发：

退款申请受理后，若商户资金不足且经过7天的重试仍未达到所需金额，将导致退款关闭。

当退款申请受理时，若订单资金状态不符合指定的出款账户要求（如尝试从不可用的分账余额中出款，但资金已全部解冻），也将导致退款关闭。

为避免退款关闭，建议商户确保资金充足并满足出款账户的相关要求。

#### Q：必须在完结分账后才能进行退款吗？

A：不需要。退款和分账是两个相互独立的操作。您完全可以先执行退款，随后再进行分账。如果需要在分账之前处理退款，可以直接调用退款接口来完成相应操作。

#### Q：退款过程中是否需要支付手续费？

A：手续费采用轧差计算方式。对于可用余额退款，即新资金流商户已结算订单的退款，微信支付平台仅扣除商户应承担的退款金额，而前期已收取的手续费则按比例直接返还给用户。具体细节请参阅[交易退款常见问题](https://kf.qq.com/faq/140225MveaUz150107JR7bEN.html)。

以一个例子说明：假设原订单金额为100元，申请退款50元，商户费率为0.6%。在这种情况下，微信支付平台将从商户的可用余额或基本户中扣除49.7元，并将微信返还的0.3元手续费一并退还给用户，总计退款金额为50元。

#### Q：为什么申请退款接口提交后仅显示请求受理成功，而非直接给出退款结果？

A：申请退款接口提交后仅显示请求受理成功，是因为资金处理包含多个环节，需一定时间完成。为确保获取准确的退款结果，建议您依据商户退款单号调用[查询单笔退款](https://pay.weixin.qq.com/doc/v3/merchant/4013071041.md)接口，进而了解具体的退款状态与进展。

#### Q：查询单笔退款接口能查询多久以前的退款记录？

A：查询单笔退款接口没有设定时间限制，任何通过申请退款接口成功处理的退款订单，都可以使用此接口查询其退款详情。

#### Q：支付和退款是否可以使用不同的商户号处理同一笔订单？

A：不可以。一旦订单支付成功，它就会与下单时传入的商户号绑定，在任何情况下都不允许其他商户号对该订单进行操作。这是微信支付平台为确保交易安全和可追溯性而设定的规则。

#### Q：退款成功后多久内会收到微信侧的退款结果通知？

A：退款成功后，微信侧一般会实时发送对应的退款结果通知。为确保能及时收到通知，建议商户检查退款通知的配置，并确保系统能够正常处理这些通知。

#### Q：部分退款后，调用查询接口查询该订单的交易状态是什么？

A：部分退款后，调用查询接口查询该订单，其交易状态将显示为“REFUND：转入退款”。

#### Q：调用退款接口时报错“缺少参数refund\_fee”，怎么解决？

A： 报错是因为未传入必填的refund\_fee参数。请检查并确保在请求中包含此参数，且值正确。建议查阅微信支付官方文档中的[申请退款](https://pay.weixin.qq.com/doc/v3/merchant/4013071036.md)部分，严格按照参数要求传递信息。

#### Q：调用申请退款API时出现错误：“code":"INVALID\_REQUEST","message":"您的请求参数与订单信息不一致”，应如何处理？

A：当您在调用申请退款API时遇到此错误，意味着您提供的请求参数与原始订单信息不匹配。请确保以下几点：

1、核对订单号：确认发起退款请求时使用的订单号与支付成功时的订单号完全一致。

2、核对商户号：确保使用的商户号与支付时的商户号相符。

3、仔细检查所有相关参数：确保所有传入的参数均准确无误。

完成上述核对后，重新尝试发起退款请求。

#### Q："查询单笔退款API"接口是否每次只能查询一条退款记录？

A：是的，[查询单笔退款API](https://pay.weixin.qq.com/doc/v3/merchant/4013071041.md)接口设计为每次只能查询一条退款记录。若需要批量查询，您可以通过多次调用该接口并传入不同的退款订单号来实现。

#### Q：调用“申请退款API”时，如果用户绑定的银行卡已注销，退款将如何处理？

A：在使用“申请退款API”处理退款时，如果用户绑定的银行卡已注销，微信支付系统会尝试将退款资金退至用户的微信零钱。若用户的微信零钱账户也已注销或不可用，退款单将进入“退款异常”状态。此时，可选择调用[发起异常退款API](https://pay.weixin.qq.com/doc/v3/merchant/4013071193.md)进行处理，或直接在商户平台[手动完成退款](https://kf.qq.com/faq/140225MveaUz150107mAVz6F.html)操作。

#### Q：调用"申请退款API"接口后，返回结果为空，应如何排查问题？

A：当调用"申请退款API"接口返回为空时，可能是由以下原因导致的：

1、响应体读取问题：请确保正确读取了响应体内容，并根据响应头中的Content-Length长度进行验证。

2、接口调用错误：检查API接口的调用是否准确无误，特别是参数设置和签名验证部分。

针对以上两点进行检查和调整，有助于解决返回结果为空的问题。

#### Q：调用"申请退款"接口时返回错误码USER\_ACCOUNT\_ABNORMAL，应如何处理？

A：当调用"申请退款"接口返回错误码USER\_ACCOUNT\_ABNORMAL时，意味着退款申请未能成功处理，这通常是由于用户账号处于异常状态，比如已注销。

针对这一情况，建议采取以下步骤：

1、核实用户账号状态：商户需要首先确认用户的账号状态。如果确认用户账号已注销，则无法继续进行退款操作。

2、检查并重新发起退款请求：如果用户账号状态正常，建议商户仔细核查退款请求中的参数是否正确，并在确认无误后重新提交退款申请。

#### Q：调用"申请退款"接口时返回错误码TRADE\_OVERDUE，是什么意思？

A：错误码TRADE\_OVERDUE表示您尝试退款的订单已超过可退款的最大期限，即在支付完成后的一年内。超出此期限的订单将无法进行退款操作。

#### Q：调用退款接口，报错提示："当前使用此业务的用户较多，请稍后再试"，应如何处理？

A：您遇到的问题可能是由于系统繁忙导致的。建议您稍后再试，如果问题仍然存在，请检查您的请求参数是否正确，或者尝试重新发起退款请求。

#### Q：调用申请退款接口时报错提示“REFUND\_FEE\_MISMATCH”，“订单金额或退款金额与之前请求不一致，请核实后再试”，应如何处理？

A：针对您遇到的“REFUND\_FEE\_MISMATCH”错误提示，可以按照以下步骤进行排查和解决：

1、核实退款金额：确保退款金额没有超过实际支付的金额。

2、total\_fee或refund\_fee（金额参数单位为分，不能加小数点）填写错误，请仔细检查确认。

3、检查退款单号：

- 如果进行了多次退款操作，请确认每次的out\_refund\_no（商户退款单号）参数都是唯一的，若重复请更换新的退款单号后再次尝试。

- 检查所使用的退款单号是否已被使用过。


遵循以上步骤，您应该能够解决该错误提示所遇到的问题。

#### Q：退款回调报文为什么是xml格式？

A：订单通过v2[申请退款](https://pay.weixin.qq.com/doc/v2/partner/4011936647.md)接口发起了退款，或者调用申请退款接口时未传入notify\_url（回调地址）且[商户平台](https://pay.weixin.qq.com/)-交易中心-退款管理-退款配置中设置了退款回调地址，发送的是v2版本xml格式[退款回调通知](https://pay.weixin.qq.com/doc/v2/merchant/4011935223.md)。

#### Q：超过一年的订单如何退款？

A：交易时间超过一年的订单暂无法提交退款，

1、直连商户可接入[商家转账](https://pay.weixin.qq.com/doc/v3/merchant/4012711988.md)或商户自行联系用户线下退款；

2、服务商需要商户自行联系用户线下退款。

#### Q：在商户平台页面操作的退款，怎么同步到自己的系统内部呢？

A：商户平台操作退款，如需接收退款结果通知，可以登录【[商户平台](https://pay.weixin.qq.com/)-交易中心-退款管理-退款配置】设置回调通知地址，设置完成后即可接收[退款结果通知](https://pay.weixin.qq.com/doc/v2/merchant/4011935223.md)，返回的是v2接口xml格式。

#### Q：订单退款后，代金券状态会变更吗？

A：请参考以下几点：

1、有效期内退款：已核销的代金券若在有效期内发生订单退款，代金券会退回用户账户并恢复为可用状态。

2、活动过期后退款：若代金券所参与的活动已过期，即使发生退款，代金券在微信侧的状态会标记为过期。

3、退款详情记录：通过 `promotion_detail` 字段可查看代金券退款详情，包含代金券ID、金额、退款金额等信息，用于追踪状态变化。

具体状态变更需结合退款时的代金券活动状态及[退款规则](https://pay.weixin.qq.com/doc/v3/merchant/4013071001.md#3.3%E3%80%81%E4%BD%BF%E7%94%A8%E4%BA%86%E4%BB%A3%E9%87%91%E5%88%B8%E7%9A%84%E8%AE%A2%E5%8D%95%E9%80%80%E6%AC%BE%E8%A7%84%E5%88%99)判断。

#### Q：订单处于分账冻结状态时，退款可以原路退回吗？

A：可以的，分账退款规则具体参考[分账退款处理](https://pay.weixin.qq.com/doc/v3/merchant/4014547102.md#Q%EF%BC%9A%E5%88%86%E8%B4%A6%E5%A6%82%E6%9E%9C%E6%9C%89%E9%80%80%E6%AC%BE%E6%80%8E%E4%B9%88%E5%A4%84%E7%90%86%EF%BC%8C%E6%98%AF%E5%90%A6%E5%8F%AF%E4%BB%A5%E5%9B%9E%E9%80%80%EF%BC%9F)。

#### Q：退款状态为CLOSED：退款关闭，是否代表退款失败？

A：代表退款失败，如还需要退款，可生成新的商户退款单号，重新调用[退款申请API](https://pay.weixin.qq.com/doc/v3/merchant/4013071036.md)。

#### Q：下单使用的mchid和appid解绑后，还可以使用接口申请退款吗？

A：可以使用接口申请退款。

v3接口：申请退款不需要传appid，可以直接申请退款。

v2接口：

- 普通商户模式：appid为必填项，填写和mchid有绑定关系的任意一个appid即可申请退款。

- 服务商模式：appid为必填项，sub\_appid为选填项，填写和mchid有绑定关系的任意一个appid即可申请退款。


#### Q：申请退款报错“异常IP请求不予受理”，什么原因？

A：请求退款的IP地址与商户平台配置的IP地址不一致。

解决方法：商户号超管登录[商户平台](https://pay.weixin.qq.com/)，通过路径「交易中心→退款管理→退款配置→退款IP白名单→开启配置」，进入配置页面后可开启/关闭白名单功能和配置IP地址；动态IP建议关闭IP配置，静态IP检查与配置的IP列表是否一致。

#### Q：查询退款接口返回退款成功，但用户反馈退款没有到账？

A：引导用户自行核实微信账单（步骤：打开微信—我—服务—钱包—右上角账单—右上角常见问题—下载账单—用做证明材料—选择对应时间导出）。

若本微信未核实到，请打开微信—我—服务—钱包—消费者保护—帮助中心—实名问题—查询名下账户核实名下是否有其它微信，核实其它微信账户的账单。

若自查未核实到，请提供下载的账单文件截图以及查询名下账户截图联系腾讯客服核实（账单需包含微信号、日期前后）。

#### Q：商户号开启了“异常退款默认退商户”功能，当退款异常时，商户还需要登录商户平台 [手动处理](https://kf.qq.com/faq/140225MveaUz150107mAVz6F.html) 或调用 [发起异常退款](https://pay.weixin.qq.com/doc/v3/merchant/4013071193.md) 接口吗？

A：不需要。

#### Q：普通商户退款接口能否退服务商模式下的订单？​

A：​ 不支持，服务商模式订单需调用[服务商退款接口](https://pay.weixin.qq.com/doc/v3/partner/4013080625.md)。

#### Q：商户平台修改退款结果回调通知地址需要操作密码吗？有修改次数限制吗？

A：需要验证操作密码，无次数限制。

#### Q：申请退款接口是否具备幂等性？

A：申请退款接口具备幂等性。

#### Q：退款单状态还是PROCESSING，但资金账单中已经有该笔退款资金支出？

A：正常逻辑，退款单受理成功后，微信侧会从交易商户的基本账户内扣除需退款的资金（资金账单会生成一笔支出记录），退款资金会进入到微信侧退款的中间账户，当退款单状态为SUCCESS（退款成功）时，表示该笔资金已经原路退回给用户。

#### Q：申请退款接口报错：{"code":"INVALID\_REQUEST";"message":"支付单号校验不一致，请核实后再试"}，什么原因？

A：同一商户退款单号(out\_refund\_no)被用于不同的微信订单号或商户订单号退款。商户退款单号(out\_refund\_no)需要在商户系统内部唯一。

#### Q：微信支付用户更换实名认证后，是否会影响原路退款？​

A：​ 视付款方式而定。若用户使用零钱支付，更换实名后可能导致原路退款失败或异常；银行卡支付会优先退卡。