微信交易退款

微信交易退款接口

1. 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家账户上。

   1. 交易时间超过一年的订单无法提交退款（按支付成功时间+365天计算）。
   2. 微信支付退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号。
   3. 请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次，单笔订单请求频率限制：1qpm，即单笔订单每分钟申请退款请求次数不超过1次。
   4. 每个支付订单的部分退款次数不能超过50次。

二、请求地址：

https://kf.fw199.com/gateway/partner/pay/wx/personal/refund

请求参数

请求示例

 @Test
    public void WxSFTRefundPayTrade() throws Exception {
        String tppay_trade_no = "4200003208202606160490456846";
        String outRefundNo = "20260618-001";
        String refund_amount = "10"; //单位是分
        String refundReason = "双方达成一致";
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("tppay_trade_no",tppay_trade_no );
        data.put("out_request_no",outRefundNo );
        data.put("refund_reason",refundReason );
        data.put("refund_amount",refund_amount );
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        String result = doHttpRequest(Config.WXPersonalRefundTradeUrl, data);
        System.out.println(result);

}

三、接口返回结果：

{
  "code": 0,
  "message": "ok",
  "data": {
    "refund_id": "50300607562026061842394414906",
    "out_refund_no": "20260618-001",
    "create_time": "2026-06-18T14:04:20+08:00",
    "amount": {
      "refund": 10,
      "payer_refund": 10,
      "currency": "CNY"
    },
    "refund_account": "REFUND_SOURCE_SUB_MERCHANT"
  },
  "trace_id": "4da9e8fa-44ee-497e-920c-39302fc3e333"
}

四、返回参数说明

返回字段中code为0表示成功，非0失败，失败的话message会有失败原因。成功的往左，会有以下字段。