常见问题

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

A： 报错是因为未传入必填的refund_fee参数。请检查并确保在请求中包含此参数，且值正确。建议查阅微信支付官方文档中的申请退款部分，严格按照参数要求传递信息。

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

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

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

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

3、核对接口模式：确保交易与退款的接口模式一致，例如：服务商模式的交易订单只能使用服务商模式的退款接口进行退款。

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

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

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

A：是的，查询单笔退款API接口设计为每次只能查询一条退款记录。若需要批量查询，您可以通过多次调用该接口并传入不同的退款订单号来实现。

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

A：在使用“申请退款API”处理退款时，如果用户绑定的银行卡已注销，微信支付系统会尝试将退款资金退至用户的微信零钱。若用户的微信零钱账户也已注销或不可用，退款单将进入“退款异常”状态。此时，可选择调用发起异常退款API进行处理，或直接在服务商平台/商户平台手动完成退款操作。

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、检查退款单号：

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

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

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

Q：申请退款接口报错："申请退款金额超过订单可退金额"，原因是什么？

A：1、退款金额超出剩余可退金额：

• 原因：申请的退款金额超过了当前订单剩余的可退款金额。

• 解决方案：请确认该订单是否已有过其他退款申请，计算实际剩余的可退金额后，调整申请退款的金额并重新尝试。

2、重复提交退款请求：

• 原因：申请退款接口支持原参数重入，但如果同一笔退款申请在短时间内多次申请退款，只有第一次会申请成功，后续的申请会返回此错误。

• 解决方案：

  • 对于同一笔订单的多次退款申请，请间隔至少一分钟再进行申请。

  • 如果需要确认退款单的信息，建议使用查询单笔退款API接口。不推荐利用申请退款接口的幂等能力来代替查询接口，幂等设计的目的是防止误操作导致的多次退款。