统一收单交易退款接口

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"
}'

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;
        }
    }
}

<?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;
}

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",
  },
});

{
  "alipay_trade_refund_response": {
    "code": "20000",
    "msg": "Service Currently Unavailable",
    "sub_code": "isp.unknow-error",
    "sub_msg": "系统繁忙"
  },
  "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}