## 接口说明

接口名称：`alipay.trade.refund`

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

交易超过约定时间（签约时设置的可退款时间）的订单无法进行退款。

支付宝退款支持单笔交易分多次退款，多次退款需要提交原支付订单的订单号，并设置不同的退款请求号。一笔退款失败后重新提交时，必须保证退款请求号不变，防止重复退款。同一笔交易累计提交的退款金额不能超过原始交易总金额。

## 注意事项

1. 同一笔交易的退款至少间隔 3 秒后发起。
2. 请严格按照接口文档中的参数接入。若传入非当前接口文档中的参数，可能造成退款失败或重复退款。
3. 该接口不可与其他退款产品混用。若商户侧同一笔退款请求已使用当前接口退款，再使用其他退款产品退款，可能造成重复退款。
4. 退款成功判断：接口返回 `fund_change=Y` 表示退款成功；`fund_change=N` 或无此字段返回时，需要通过退款查询接口进一步确认退款状态。详见[退款成功判断指导](https://ideservice.alipay.com/cms/site/01rawa)。接口中 `code=10000` 仅代表本次退款请求成功，不代表退款成功。
5. 若退款原订单涉及分账，在发起退款前，需要分账接收方在[支付宝商家平台](https://b.alipay.com/page/portal/home) > 资金管理 > 资金服务 > 分账接收设置中开启分账回退授权后，才可以正常退款。且不支持接收方为个人的分账单发起退款退分账。

## 公共请求参数

| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
| --- | --- | --- | --- | --- | --- |
| `app_id` | String | 必选 | 32 | 支付宝分配给开发者的应用 ID | `2014072300007148` |
| `method` | String | 必选 | 128 | 接口名称 | `alipay.trade.refund` |
| `format` | String | 可选 | 40 | 仅支持 JSON | `JSON` |
| `charset` | String | 必选 | 10 | 请求使用的编码格式，如 `utf-8`、`gbk`、`gb2312` 等 | `utf-8` |
| `sign_type` | String | 必选 | 10 | 商户生成签名字符串所使用的签名算法类型，目前支持 `RSA2` 和 `RSA`，推荐使用 `RSA2` | `RSA2` |
| `sign` | String | 必选 | 344 | 商户请求参数的签名串，详见[签名](https://ideservice.alipay.com/cms/site/02khjm) | 详见示例 |
| `timestamp` | String | 必选 | 19 | 发送请求的时间，格式为 `yyyy-MM-dd HH:mm:ss` | `2014-07-24 03:07:50` |
| `version` | String | 必选 | 3 | 调用的接口版本，固定为 `1.0` | `1.0` |
| `app_auth_token` | String | 可选 | 40 | 详见[应用授权概述](https://ideservice.alipay.com/cms/site/04h2nx) | - |
| `biz_content` | String | 必选 | - | 请求参数集合。除公共参数外，所有请求参数都必须放在该参数中传递，具体参照各产品快速接入文档 | - |

## 业务请求参数

> `out_trade_no` 与 `trade_no` 二选一传入，不能同时为空。两者同时存在时，优先使用 `trade_no`。

| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 注意事项/枚举值 | 示例值 |
| --- | --- | --- | --- | --- | --- | --- |
| `refund_amount` | price | 必选 | 16 | 退款金额，单位为元，支持两位小数，不能大于订单金额 | 如果正向交易使用了营销，该退款金额包含营销金额。支付宝会按业务规则分配营销和买家自有资金分别退多少，默认优先退买家的自有资金 | `200.12` |
| `out_trade_no` | string | 二选一 | 64 | 商户订单号，订单支付时传入，商家自定义且保证商家系统中唯一 | 与 `trade_no` 不能同时为空 | `20150320010101001` |
| `trade_no` | string | 二选一 | 64 | 支付宝交易号 | 与 `out_trade_no` 不能同时为空；两者同时存在时，优先取 `trade_no` | `2014112611001004680073956707` |
| `refund_reason` | string | 可选 | 256 | 退款原因说明，商家自定义 | 会在商户和用户的 PC 退款账单详情中展示 | `正常退款` |
| `out_request_no` | string | 可选 | 64 | 退款请求号，标识一次退款请求，需要保证在交易号下唯一 | 部分退款时必选。同一次退款请求失败或异常后重试时，必须保证退款请求号不变，防止重复退款。支付宝会保证同样的退款请求号多次请求只退一次 | `HZ01RF001` |

## 请求示例

::::aipay-tabs{defaultActiveKey="Java"}
:::aipay-tab{key="cURL" title="cURL"}
```bash
curl 'https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.refund&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'app_auth_token=${app_auth_token}' \
 -F 'biz_content={
	"out_trade_no":"20150320010101001",
	"trade_no":"2014112611001004680073956707",
	"refund_amount":"200.12",
	"refund_reason":"正常退款",
	"out_request_no":"HZ01RF001",
	"refund_goods_detail":[
		{
			"out_sku_id":"outSku_01",
			"out_item_id":"outItem_01",
			"goods_id":"apple-01",
			"refund_amount":"19.50",
			"out_certificate_no_list":[
				"202407013232143241231243243423"
			]
		}
	],
	"refund_royalty_parameters":[
		{
			"amount":"0.1",
			"trans_in":"2088101126708402",
			"royalty_type":"transfer",
			"trans_out":"2088101126765726",
			"trans_out_type":"userId",
			"royalty_scene":"达人佣金",
			"trans_in_type":"userId",
			"trans_in_name":"张三",
			"desc":"分账给2088101126708402"
		}
	],
	"query_options":[
		"refund_detail_item_list"
	],
	"related_settle_confirm_no":"2024041122001495000530302869"
}'
```
:::

:::aipay-tab{key="Java" title="Java"}
```java
package com.java.sdk.demo;

import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.AlipayConfig;
import com.alipay.api.domain.AlipayTradeRefundModel;
import com.alipay.api.request.AlipayTradeRefundRequest;
import com.alipay.api.response.AlipayTradeRefundResponse;
import com.alipay.api.domain.RefundGoodsDetail;
import com.alipay.api.domain.OpenApiRoyaltyDetailInfoPojo;

import com.alipay.api.FileItem;
import java.util.Base64;
import java.util.ArrayList;
import java.util.List;

public class AlipayTradeRefund {

    public static void main(String[] args) throws AlipayApiException {
        // 初始化SDK
        AlipayClient alipayClient = new DefaultAlipayClient(getAlipayConfig());

        // 构造请求参数以调用接口
        AlipayTradeRefundRequest request = new AlipayTradeRefundRequest();
        AlipayTradeRefundModel model = new AlipayTradeRefundModel();
        
        // 设置商户订单号
        model.setOutTradeNo("20150320010101001");
        
        // 设置支付宝交易号
        model.setTradeNo("2014112611001004680073956707");
        
        // 设置退款金额
        model.setRefundAmount("200.12");
        
        // 设置退款原因说明
        model.setRefundReason("正常退款");
        
        // 设置退款请求号
        model.setOutRequestNo("HZ01RF001");
        
        // 设置退款包含的商品列表信息
        List<RefundGoodsDetail> refundGoodsDetail = new ArrayList<RefundGoodsDetail>();
        RefundGoodsDetail refundGoodsDetail0 = new RefundGoodsDetail();
        refundGoodsDetail0.setOutSkuId("outSku_01");
        refundGoodsDetail0.setOutItemId("outItem_01");
        refundGoodsDetail0.setGoodsId("apple-01");
        refundGoodsDetail0.setRefundAmount("19.50");
        List<String> outCertificateNoList = new ArrayList<String>();
        outCertificateNoList.add("202407013232143241231243243423");
        refundGoodsDetail0.setOutCertificateNoList(outCertificateNoList);
        refundGoodsDetail.add(refundGoodsDetail0);
        model.setRefundGoodsDetail(refundGoodsDetail);
        
        // 设置退分账明细信息
        List<OpenApiRoyaltyDetailInfoPojo> refundRoyaltyParameters = new ArrayList<OpenApiRoyaltyDetailInfoPojo>();
        OpenApiRoyaltyDetailInfoPojo refundRoyaltyParameters0 = new OpenApiRoyaltyDetailInfoPojo();
        refundRoyaltyParameters0.setAmount("0.1");
        refundRoyaltyParameters0.setTransIn("2088101126708402");
        refundRoyaltyParameters0.setRoyaltyType("transfer");
        refundRoyaltyParameters0.setTransOut("2088101126765726");
        refundRoyaltyParameters0.setTransOutType("userId");
        refundRoyaltyParameters0.setRoyaltyScene("达人佣金");
        refundRoyaltyParameters0.setTransInType("userId");
        refundRoyaltyParameters0.setTransInName("张三");
        refundRoyaltyParameters0.setDesc("分账给2088101126708402");
        refundRoyaltyParameters.add(refundRoyaltyParameters0);
        model.setRefundRoyaltyParameters(refundRoyaltyParameters);
        
        // 设置查询选项
        List<String> queryOptions = new ArrayList<String>();
        queryOptions.add("refund_detail_item_list");
        model.setQueryOptions(queryOptions);
        
        // 设置针对账期交易
        model.setRelatedSettleConfirmNo("2024041122001495000530302869");
        
        request.setBizModel(model);
        // 第三方代调用模式下请设置app_auth_token
        // request.putOtherTextParam("app_auth_token", "<-- 请填写应用授权令牌 -->");

        AlipayTradeRefundResponse response = alipayClient.execute(request);
        System.out.println(response.getBody());

        if (response.isSuccess()) {
            System.out.println("调用成功");
        } else {
            System.out.println("调用失败");
            // sdk版本是"4.38.0.ALL"及以上,可以参考下面的示例获取诊断链接
            // String diagnosisUrl = DiagnosisUtils.getDiagnosisUrl(response);
            // System.out.println(diagnosisUrl);
        }
    }

    private static AlipayConfig getAlipayConfig() {
        String privateKey  = "<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->";
        String alipayPublicKey = "<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->";
        AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl("https://openapi.alipay.com/gateway.do");
        alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
        alipayConfig.setPrivateKey(privateKey);
        alipayConfig.setFormat("json");
        alipayConfig.setAlipayPublicKey(alipayPublicKey);
        alipayConfig.setCharset("UTF-8");
        alipayConfig.setSignType("RSA2");
        return alipayConfig;
    }
}
```
:::

:::aipay-tab{key="C#" title="C#"}
```csharp
using System;
using System.Collections.Generic;
using Aop.Api;
using Aop.Api.Request;
using Aop.Api.Response;
using Aop.Api.Domain;
using Aop.Api.Util;
namespace SdkDemoTest
{
    public class AlipayTradeRefund
    {
        public static void Main(string[] args) 
        {
            // 初始化SDK
            IAopClient alipayClient = new DefaultAopClient(GetAlipayConfig());
            // 构造请求参数以调用接口
            AlipayTradeRefundRequest request = new AlipayTradeRefundRequest();
            AlipayTradeRefundModel model = new AlipayTradeRefundModel();
            
            // 设置商户订单号
            model.OutTradeNo = "20150320010101001";
            
            // 设置支付宝交易号
            model.TradeNo = "2014112611001004680073956707";
            
            // 设置退款金额
            model.RefundAmount = "200.12";
            
            // 设置退款原因说明
            model.RefundReason = "正常退款";
            
            // 设置退款请求号
            model.OutRequestNo = "HZ01RF001";
            
            // 设置退款包含的商品列表信息
            List<RefundGoodsDetail> refundGoodsDetail = new List<RefundGoodsDetail>();
            RefundGoodsDetail refundGoodsDetail0 = new RefundGoodsDetail();
            refundGoodsDetail0.OutSkuId = "outSku_01";
            refundGoodsDetail0.OutItemId = "outItem_01";
            refundGoodsDetail0.GoodsId = "apple-01";
            refundGoodsDetail0.RefundAmount = "19.50";
            List<String> outCertificateNoList = new List<String>();
            outCertificateNoList.Add("202407013232143241231243243423");
            refundGoodsDetail0.OutCertificateNoList = outCertificateNoList;
            refundGoodsDetail.Add(refundGoodsDetail0);
            model.RefundGoodsDetail = refundGoodsDetail;
            
            // 设置退分账明细信息
            List<OpenApiRoyaltyDetailInfoPojo> refundRoyaltyParameters = new List<OpenApiRoyaltyDetailInfoPojo>();
            OpenApiRoyaltyDetailInfoPojo refundRoyaltyParameters0 = new OpenApiRoyaltyDetailInfoPojo();
            refundRoyaltyParameters0.Amount = "0.1";
            refundRoyaltyParameters0.TransIn = "2088101126708402";
            refundRoyaltyParameters0.RoyaltyType = "transfer";
            refundRoyaltyParameters0.TransOut = "2088101126765726";
            refundRoyaltyParameters0.TransOutType = "userId";
            refundRoyaltyParameters0.RoyaltyScene = "达人佣金";
            refundRoyaltyParameters0.TransInType = "userId";
            refundRoyaltyParameters0.TransInName = "张三";
            refundRoyaltyParameters0.Desc = "分账给2088101126708402";
            refundRoyaltyParameters.Add(refundRoyaltyParameters0);
            model.RefundRoyaltyParameters = refundRoyaltyParameters;
            
            // 设置查询选项
            List<String> queryOptions = new List<String>();
            queryOptions.Add("refund_detail_item_list");
            model.QueryOptions = queryOptions;
            
            // 设置针对账期交易
            model.RelatedSettleConfirmNo = "2024041122001495000530302869";
            
            request.SetBizModel(model);
            // 第三方代调用模式下请设置app_auth_token
            // request.PutOtherTextParam("app_auth_token", "<-- 请填写应用授权令牌 -->");

            AlipayTradeRefundResponse response = alipayClient.Execute(request);

            if(!response.IsError)
            {
                Console.WriteLine("调用成功");
            }
            else
            {
                Console.WriteLine("调用失败");
            }
        }

        private static AlipayConfig GetAlipayConfig()
        {
            string privateKey  = "<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->";
            string alipayPublicKey = "<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->";
            AlipayConfig alipayConfig = new AlipayConfig();
            alipayConfig.ServerUrl = "https://openapi.alipay.com/gateway.do";
            alipayConfig.AppId = "<-- 请填写您的AppId，例如：2019091767145019 -->";
            alipayConfig.PrivateKey = privateKey;
            alipayConfig.Format = "json";
            alipayConfig.AlipayPublicKey = alipayPublicKey;
            alipayConfig.Charset = "UTF-8";
            alipayConfig.SignType = "RSA2";
            return alipayConfig;
        }
    }
}
```
:::

:::aipay-tab{key="PHP" title="PHP"}
```php
<?php
require_once '../aop/AopClient.php';
require_once '../aop/AopCertClient.php';
require_once '../aop/AopCertification.php';
require_once '../aop/AlipayConfig.php';
require_once '../aop/request/AlipayTradeRefundRequest.php';

// 初始化SDK
$alipayClient = new AopClient(getAlipayConfig());
// 构造请求参数以调用接口
$request = new AlipayTradeRefundRequest();
$model = array();

// 设置商户订单号
$model['out_trade_no'] = "20150320010101001";

// 设置支付宝交易号
$model['trade_no'] = "2014112611001004680073956707";

// 设置退款金额
$model['refund_amount'] = "200.12";

// 设置退款原因说明
$model['refund_reason'] = "正常退款";

// 设置退款请求号
$model['out_request_no'] = "HZ01RF001";

// 设置退款包含的商品列表信息
$refundGoodsDetail = array();
$refundGoodsDetail0 = array();
$refundGoodsDetail0['out_sku_id'] = "outSku_01";
$refundGoodsDetail0['out_item_id'] = "outItem_01";
$refundGoodsDetail0['goods_id'] = "apple-01";
$refundGoodsDetail0['refund_amount'] = "19.50";
$outCertificateNoList = array();
$outCertificateNoList[] = "202407013232143241231243243423";
$refundGoodsDetail0['out_certificate_no_list'] = $outCertificateNoList;
$refundGoodsDetail[] = $refundGoodsDetail0;
$model['refund_goods_detail'] = $refundGoodsDetail;

// 设置退分账明细信息
$refundRoyaltyParameters = array();
$refundRoyaltyParameters0 = array();
$refundRoyaltyParameters0['amount'] = "0.1";
$refundRoyaltyParameters0['trans_in'] = "2088101126708402";
$refundRoyaltyParameters0['royalty_type'] = "transfer";
$refundRoyaltyParameters0['trans_out'] = "2088101126765726";
$refundRoyaltyParameters0['trans_out_type'] = "userId";
$refundRoyaltyParameters0['royalty_scene'] = "达人佣金";
$refundRoyaltyParameters0['trans_in_type'] = "userId";
$refundRoyaltyParameters0['trans_in_name'] = "张三";
$refundRoyaltyParameters0['desc'] = "分账给2088101126708402";
$refundRoyaltyParameters[] = $refundRoyaltyParameters0;
$model['refund_royalty_parameters'] = $refundRoyaltyParameters;

// 设置查询选项
$queryOptions = array();
$queryOptions[] = "refund_detail_item_list";
$model['query_options'] = $queryOptions;

// 设置针对账期交易
$model['related_settle_confirm_no'] = "2024041122001495000530302869";

$request->setBizContent(json_encode($model,JSON_UNESCAPED_UNICODE));
// 如果是第三方代调用模式，请设置app_auth_token（应用授权令牌）
$responseResult = $alipayClient->execute($request, null, "<-- 请填写应用授权令牌 -->", null);
$responseApiName = str_replace(".","_",$request->getApiMethodName())."_response";
$response = $responseResult->$responseApiName;
if(!empty($response->code)&&$response->code==10000){
    echo("调用成功");
}
else{
    echo("调用失败");
}

function getAlipayConfig()
{
    $privateKey  = '<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->';
    $alipayPublicKey = '<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->';
    $alipayConfig = new AlipayConfig();
    $alipayConfig->setServerUrl('https://openapi.alipay.com/gateway.do');
    $alipayConfig->setAppId('<-- 请填写您的AppId，例如：2019091767145019 -->');
    $alipayConfig->setPrivateKey($privateKey);
    $alipayConfig->setFormat('json');
    $alipayConfig->setAlipayPublicKey($alipayPublicKey);
    $alipayConfig->setCharset('UTF-8');
    $alipayConfig->setSignType('RSA2');
    return $alipayConfig;
}
```
:::

:::aipay-tab{key="Node.js" title="Node.js"}
```javascript
const AlipaySdk = require("alipay-sdk").default;

const alipaySdk = new AlipaySdk({
  appId: "<-- 请填写您的AppId，例如：2019091767145019 -->",
  privateKey: "<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->",
  alipayPublicKey: "<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->",
  gateway: "https://openapi.alipay.com/gateway.do",
});
const result = await alipaySdk.exec("alipay.trade.refund", {
  bizContent: {
    out_trade_no: "20150320010101001",
    trade_no: "2014112611001004680073956707",
    refund_amount: "200.12",
    refund_reason: "正常退款",
    out_request_no: "HZ01RF001",
    refund_goods_detail: {
      0: {
        out_sku_id: "outSku_01",
        out_item_id: "outItem_01",
        goods_id: "apple-01",
        refund_amount: "19.50",
        out_certificate_no_list: {
          0: "202407013232143241231243243423",
        },
      },
    },
    refund_royalty_parameters: {
      0: {
        amount: "0.1",
        trans_in: "2088101126708402",
        royalty_type: "transfer",
        trans_out: "2088101126765726",
        trans_out_type: "userId",
        royalty_scene: "达人佣金",
        trans_in_type: "userId",
        trans_in_name: "张三",
        desc: "分账给2088101126708402",
      },
    },
    query_options: {
      0: "refund_detail_item_list",
    },
    related_settle_confirm_no: "2024041122001495000530302869",
  },
});
```
:::

::::


## 公共响应参数

| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
| --- | --- | --- | --- | --- | --- |
| `code` | String | 必选 | - | 网关返回码，详见[公共错误码](https://ideservice.alipay.com/cms/site/02km9f) | `40004` |
| `msg` | String | 必选 | - | 网关返回码描述，详见[公共错误码](https://ideservice.alipay.com/cms/site/02km9f) | `Business Failed` |
| `sub_code` | String | 可选 | - | 业务返回码，参见具体 API 接口文档 | `ACQ.TRADE_HAS_SUCCESS` |
| `sub_msg` | String | 可选 | - | 业务返回码描述，参见具体 API 接口文档 | `交易已被支付` |
| `sign` | String | 必选 | - | 签名，详见[签名文档](https://ideservice.alipay.com/cms/site/02kf5q) | `DZXh8eeTuAHoYE...` |

## 业务响应参数

| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 注意事项/枚举值 | 示例值 |
| --- | --- | --- | --- | --- | --- | --- |
| `trade_no` | string | 必选 | 64 | 支付宝交易号 | - | `2013112011001004330000121536` |
| `out_trade_no` | string | 必选 | 64 | 商户订单号 | - | `6823789339978248` |
| `buyer_logon_id` | string | 必选 | 100 | 用户的登录 ID | - | `159****5620` |
| `refund_fee` | price | 必选 | 11 | 退款总金额，单位为元 | 指该笔交易累计已经退款成功的金额 | `88.88` |
| `buyer_user_id` | string | 特殊可选 | 28 | 买家在支付宝的用户 ID | 新商户建议使用 `buyer_open_id` 替代该字段。对于新商户，`buyer_user_id` 字段未来计划逐步回收，存量商户可继续使用。若使用 `buyer_open_id`，请确认“应用 - 开发配置 - openid 配置管理”已启用；无该配置项时，可查看 [openid 配置申请](https://ideservice.alipay.com/cms/site/0ai9ok?pathHash=de631c06) | `2088101117955611` |
| `buyer_open_id` | string | 特殊可选 | 128 | 买家支付宝用户唯一标识 | 详情可查看 [openid 简介](https://ideservice.alipay.com/cms/site/0ai2i6?pathHash=13dd5946) | `074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5` |
| `send_back_fee` | string | 特殊可选 | 11 | 本次商户实际退回金额，单位为元 | 如需获取该值，需在入参 `query_options` 中传入 `refund_detail_item_list` | `1.8` |
| `fund_change` | string | 可选 | 1 | 本次退款是否发生了资金变化 | `Y` 通常表示退款成功；`N` 或无此字段时需通过退款查询接口进一步确认退款状态 | `Y` |

## 响应示例

::::aipay-tabs{defaultActiveKey="正常示例"}
:::aipay-tab{key="正常示例" title="正常示例"}
```json
{
  "alipay_trade_refund_response": {
    "code": "10000",
    "msg": "Success",
    "trade_no": "2013112011001004330000121536",
    "out_trade_no": "6823789339978248",
    "buyer_logon_id": "159****5620",
    "fund_change": "Y",
    "refund_fee": "88.88",
    "refund_detail_item_list": [
      {
        "fund_channel": "ALIPAYACCOUNT",
        "amount": "10",
        "real_amount": "11.21",
        "fund_type": "DEBIT_CARD"
      }
    ],
    "store_name": "望湘园联洋店",
    "buyer_user_id": "2088101117955611",
    "buyer_open_id": "074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5",
    "send_back_fee": "1.8",
    "refund_hyb_amount": "10.24",
    "refund_charge_info_list": [
      {
        "refund_charge_fee": "0.01",
        "switch_fee_rate": "0.01",
        "charge_type": "trade",
        "refund_sub_fee_detail_list": [
          {
            "refund_charge_fee": "0.10",
            "switch_fee_rate": "0.01"
          }
        ]
      }
    ],
    "refund_voucher_detail_list": [
      {
        "id": "2015102600073002039000002D5O",
        "name": "XX超市5折优惠",
        "type": "ALIPAY_FIX_VOUCHER",
        "amount": "10.00",
        "merchant_contribute": "9.00",
        "other_contribute": "1.00",
        "memo": "学生专用优惠",
        "template_id": "20171030000730015359000EMZP0",
        "other_contribute_detail": [
          {
            "contribute_type": "BRAND",
            "contribute_amount": "8.00"
          }
        ],
        "purchase_buyer_contribute": "2.01",
        "purchase_merchant_contribute": "1.03",
        "purchase_ant_contribute": "0.82"
      }
    ],
    "pre_auth_cancel_fee": "12.45"
  },
  "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}
```
:::

:::aipay-tab{key="异常示例" title="异常示例"}
```json
{
  "alipay_trade_refund_response": {
    "code": "20000",
    "msg": "Service Currently Unavailable",
    "sub_code": "isp.unknow-error",
    "sub_msg": "系统繁忙"
  },
  "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}
```
:::

::::


## 公共错误码

[前往查看公共错误码](https://ideservice.alipay.com/cms/site/02km9f)

## 业务错误码

| 错误码 | 错误描述 | 解决方案 |
| --- | --- | --- |
| `ACQ.ALLOC_AMOUNT_VALIDATE_ERROR` | 退分账金额超限 | 请调整退分账金额后重试 |
| `ACQ.BUYER_ENABLE_STATUS_FORBID` | 买家状态异常 | 联系支付宝小二确认买家状态异常原因，或者联系买家进行线下退款处理 |
| `ACQ.BUYER_ERROR` | 买家状态异常 | 联系支付宝小二确认买家状态异常原因，或者联系买家进行线下退款处理 |
| `ACQ.BUYER_NOT_EXIST` | 买家不存在 | 买家已经注销账号，建议联系买家进行线下退款处理 |
| `ACQ.CURRENCY_NOT_SUPPORT` | 退款币种不支持 | 请确认传入的退款币种是否正确 |
| `ACQ.CUSTOMER_VALIDATE_ERROR` | 账户已注销或者被冻结 | 请查询账户状态：如果账户已注销，请线下处理；如果账户已冻结，请联系支付宝小二确认冻结原因 |
| `ACQ.DISCORDANT_REPEAT_REQUEST` | 请求信息不一致 | 退款请求号对应的退款已经执行成功，且本次请求的退款金额与之前请求的金额不一致。请检查退款金额是否正确，或通过退款查询接口获取退款执行结果 |
| `ACQ.ENTERPRISE_PAY_BIZ_ERROR` | 因公付业务异常 | 如果提示“当前交易不含企业出资”，请确认交易是否包含企业出资；如果不包含，接口入参不能指定 `enterprise_pay_info`；如果确认包含，请联系支付宝核实。如果提示“无效企业退款金额”，请检查指定的企业退款金额是否超过当前交易企业支付的金额。其他情况请联系支付宝小二 |
| `ACQ.INVALID_PARAMETER` | 参数无效 | 请根据接口返回的错误信息检查请求参数，修改后重新发起请求 |
| `ACQ.NOT_ALLOW_PARTIAL_REFUND` | 不支持部分退款 | 由于交易使用了特定优惠券等场景，该笔交易不支持部分退款，请进行全额退款或联系买家线下退款 |
| `ACQ.ONLINE_TRADE_VOUCHER_NOT_ALLOW_REFUND` | 交易不允许退款 | 此交易中核销了购买的代金券，不允许退款，可联系买家线下退款 |
| `ACQ.OVERDRAFT_AGREEMENT_NOT_MATCH` | 垫资退款接口传入模式和签约配置不一致 | 请检查垫资退款合约中的出资方式，修改合约或接口传参后重试 |
| `ACQ.OVERDRAFT_ASSIGN_ACCOUNT_INVALID` | 垫资退款出资账号和商户信息不一致 | 垫资退款出资账号必须为商户名下支付宝账号，请更换出资账号后重试 |
| `ACQ.REASON_TRADE_BEEN_FREEZEN` | 请求退款的交易被冻结 | 联系支付宝小二确认该笔交易的具体情况 |
| `ACQ.REASON_TRADE_REFUND_FEE_ERR` | 退款金额无效 | 同一笔交易累计请求的退款金额不能大于交易总金额，请检查退款请求金额是否正确 |
| `ACQ.REASON_TRADE_STATUS_INVALID` | 交易状态异常 | 查询交易，确认交易是否为支付成功状态；如是，可联系支付宝小二确认交易状态 |
| `ACQ.REFUNDALLOC_UNAUTH_LIMIT` | 分账接收方未开启分账回退，退分账失败 | 请联系分账接收方在支付宝商家平台 > 资金管理 > 资金服务 > 分账接收设置中开启分账回退授权后再发起调用 |
| `ACQ.REFUND_ACCOUNT_NOT_EXIST` | 退款出资账号不存在或账号异常 | 检查退款出资账号状态，账号正常后重试 |
| `ACQ.REFUND_AMT_NOT_EQUAL_TOTAL` | 退款金额超限 | 请检查退款金额是否正确，请求退款金额不能大于交易总金额；如果不是全额退款，退款请求号必填，请检查是否传入退款请求号 |
| `ACQ.REFUND_CHARGE_ERROR` | 退收费异常 | 请过一段时间后再重试发起退款 |
| `ACQ.REFUND_FEE_ERROR` | 交易退款金额有误 | 请检查传入的退款金额是否正确 |
| `ACQ.REFUND_ROYALTY_PAYEE_ACCOUNT_NOT_EXIST` | 退分账收入方账户不存在 | 请确认收入方账号是否正确，更换账号后重新发起 |
| `ACQ.SELLER_BALANCE_NOT_ENOUGH` | 卖家余额不足 | 商户支付宝账户充值后重新发起退款 |
| `ACQ.SYSTEM_ERROR` | 系统错误 | 当前退款请求可能成功也可能失败。请使用相同参数再次重试，保证退款请求号和退款金额不变；如果前一次退款已经成功，接口会幂等返回成功；如果前一次未成功，接口会重试执行退款。也可通过退款查询接口查询退款执行结果，发起退款查询需保证距离退款请求大于 5 秒 |
| `ACQ.TRADE_HAS_CLOSE` | 交易已关闭 | 该交易已关闭，不能再退款，请确认请求退款的交易是否未支付或已完成退款 |
| `ACQ.TRADE_HAS_FINISHED` | 交易已完结 | 该交易已完结，已超过退款期限，不允许退款；建议联系买家线下退款 |
| `ACQ.TRADE_NOT_ALLOW_REFUND` | 当前交易不允许退款 | 检查当前交易状态是否为交易成功状态，以及签约的退款属性是否允许退款，确认后重新发起请求 |
| `ACQ.TRADE_NOT_EXIST` | 交易不存在 | 检查请求中的交易号和商户订单号是否正确，确认后重新发起 |
| `ACQ.TRADE_SETTLE_ERROR` | 交易结算异常 | 请检查传入的退结算项信息是否正确；如果正确，请联系支付宝小二 |
| `ACQ.TRADE_STATUS_ERROR` | 交易状态非法 | 查询交易，确认交易是否已经付款 |
| `ACQ.USER_NOT_MATCH_ERR` | 交易用户不匹配 | 请联系支付宝小二处理 |