查询退款api-微信合单支付文档(2.0)

AI助手支持GPT4.0

查询退款

应用场景

提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。

注意：如果单个支付订单部分退款次数超过20次请使用退款单号查询

分页查询

当一个订单部分退款超过10笔后，商户用微信订单号或商户订单号调退款查询API查询退款时，默认返回前10笔和total_refund_count（订单总退款次数）。商户需要查询同一订单下超过10笔的退款单时，可传入订单号及offset来查询，微信支付会返回offset及后面的10笔，以此类推。当商户传入的offset超过total_refund_count，则系统会返回报错PARAM_ERROR。

举例：

一笔订单下的退款单有36笔，当商户想查询第25笔时，可传入订单号及offset=24，微信支付平台会返回第25笔到第35笔的退款单信息，或商户可直接传入退款单号查询退款

退款状态机

退款状态变化如下：
       

接口地址

接口链接：https://api.mch.weixin.qq.com/pay/refundquery

是否需要证书

不需要。

请求参数

举例如下：

<xml>
          <appid>wx2421b1c4370ec43b</appid>
          <mch_id>10000100</mch_id>
          <nonce_str>0b9f35f484df17a732e537c37708d1d0</nonce_str>
          <out_refund_no></out_refund_no>
          <out_trade_no>1415757673</out_trade_no>
          <refund_id></refund_id>
          <transaction_id></transaction_id>
          <sign>66FFB727015F450D167EF38CCC549521</sign>
       </xml>

返回数据

以下字段在return_code为SUCCESS的时候有返回

举例如下：

<xml>
          <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
          <mch_id><![CDATA[10000100]]></mch_id>
          <nonce_str><![CDATA[TeqClE3i0mvn3DrK]]></nonce_str>
          <out_refund_no_0><![CDATA[1415701182]]></out_refund_no_0>
          <out_trade_no><![CDATA[1415757673]]></out_trade_no>
          <refund_count>1</refund_count>
          <refund_fee_0>1</refund_fee_0>
          <refund_id_0><![CDATA[2008450740201411110000174436]]></refund_id_0>
          <refund_status_0><![CDATA[PROCESSING]]></refund_status_0>
          <result_code><![CDATA[SUCCESS]]></result_code>
          <return_code><![CDATA[SUCCESS]]></return_code>
          <return_msg><![CDATA[OK]]></return_msg>
          <sign><![CDATA[1F2841558E233C33ABA71A961D27561C]]></sign>
          <transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
       </xml>

错误码