阿里安全开放平台-阿里聚安全

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
refund_apply_info	RefundApplyInfo	必须			请求对象
└ out_order_id String 必须 3012312111 外部主单号 └ out_shop_id String 可选 30123121 外部渠道店ID(与shop_id必选其一) └ out_refund_id String 必须 30123121 外部逆向单ID └ refund_fee Number 必须 123 申请退款金额，单位：分 └ refund_reason String 可选不想要了退款原因 └ refund_post_fee Number 可选 12 退的运费 └ refund_package_fee Number 可选 34 退的包装费 sub_refund_orders SubRefundOrder [] 必须 [] 逆向子单列表 └ sub_out_order_id String 必须 30123121 外部子单号 └ refund_quantity Number 必须 1 退款数量 └ refund_fee Number 必须 12 退款金额，单位：分 └ order_from Number 可选 1 渠道来源(选填out_shop_id时该值必填) └ shop_id String 可选 301312 渠道店id(与out_shop_id必选其一) └ refund_type Number 可选 1 退款类型，1:仅退款。2.仅退货。3.退货退款 └ refund_note String 可选因为不新鲜，所以退了退款备注、或问题描述等补充性文本 └ refund_pics String [] 可选 [""] 退款图片清单

名称	类型	示例值	描述
api_result	ApiResult		结果
└ err_msg String 成功返回码说明 └ err_code String SUCCESS 返回码 └ success Boolean true 是否成功

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTclsAelophyMerchantChannelRefundApplyRequest req = new AlibabaTclsAelophyMerchantChannelRefundApplyRequest();
AlibabaTclsAelophyMerchantChannelRefundApplyRequest.RefundApplyInfo obj1 = new AlibabaTclsAelophyMerchantChannelRefundApplyRequest.RefundApplyInfo();
obj1.setOutOrderId("3012312111");
obj1.setOutShopId("30123121");
obj1.setOutRefundId("30123121");
obj1.setRefundFee(123L);
obj1.setRefundReason("不想要了");
obj1.setRefundPostFee(12L);
obj1.setRefundPackageFee(34L);
List<AlibabaTclsAelophyMerchantChannelRefundApplyRequest.SubRefundOrder> list3 = new ArrayList<AlibabaTclsAelophyMerchantChannelRefundApplyRequest.SubRefundOrder>();
AlibabaTclsAelophyMerchantChannelRefundApplyRequest.SubRefundOrder obj4 = new AlibabaTclsAelophyMerchantChannelRefundApplyRequest.SubRefundOrder();
list3.add(obj4);
obj4.setSubOutOrderId("30123121");
obj4.setRefundQuantity(1L);
obj4.setRefundFee(12L);
obj1.setSubRefundOrders(list3);
obj1.setOrderFrom(1L);
obj1.setShopId("301312");
obj1.setRefundType(1L);
obj1.setRefundNote("因为不新鲜，所以退了");
obj1.setRefundPics("""");
req.setRefundApplyInfo(obj1);
AlibabaTclsAelophyMerchantChannelRefundApplyResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaTclsAelophyMerchantChannelRefundApplyRequest req = new AlibabaTclsAelophyMerchantChannelRefundApplyRequest();
AlibabaTclsAelophyMerchantChannelRefundApplyRequest.RefundApplyInfoDomain obj1 = new AlibabaTclsAelophyMerchantChannelRefundApplyRequest.RefundApplyInfoDomain();
obj1.OutOrderId = "3012312111";
obj1.OutShopId = "30123121";
obj1.OutRefundId = "30123121";
obj1.RefundFee = 123L;
obj1.RefundReason = "不想要了";
obj1.RefundPostFee = 12L;
obj1.RefundPackageFee = 34L;
List<AlibabaTclsAelophyMerchantChannelRefundApplyRequest.SubRefundOrderDomain> list3 = new List<AlibabaTclsAelophyMerchantChannelRefundApplyRequest.SubRefundOrderDomain>();
AlibabaTclsAelophyMerchantChannelRefundApplyRequest.SubRefundOrderDomain obj4 = new AlibabaTclsAelophyMerchantChannelRefundApplyRequest.SubRefundOrderDomain();
list3.Add(obj4);
obj4.SubOutOrderId = "30123121";
obj4.RefundQuantity = 1L;
obj4.RefundFee = 12L;
obj1.SubRefundOrders= list3;
obj1.OrderFrom = 1L;
obj1.ShopId = "301312";
obj1.RefundType = 1L;
obj1.RefundNote = "因为不新鲜，所以退了";
obj1.RefundPics = """";
req.RefundApplyInfo_ = obj1;
AlibabaTclsAelophyMerchantChannelRefundApplyResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaTclsAelophyMerchantChannelRefundApplyRequest;
$refund_apply_info = new RefundApplyInfo;
$refund_apply_info->out_order_id="3012312111";
$refund_apply_info->out_shop_id="30123121";
$refund_apply_info->out_refund_id="30123121";
$refund_apply_info->refund_fee="123";
$refund_apply_info->refund_reason="不想要了";
$refund_apply_info->refund_post_fee="12";
$refund_apply_info->refund_package_fee="34";
$sub_refund_orders = new SubRefundOrder;
$sub_refund_orders->sub_out_order_id="30123121";
$sub_refund_orders->refund_quantity="1";
$sub_refund_orders->refund_fee="12";
$refund_apply_info->sub_refund_orders = $sub_refund_orders;
$refund_apply_info->order_from="1";
$refund_apply_info->shop_id="301312";
$refund_apply_info->refund_type="1";
$refund_apply_info->refund_note="因为不新鲜，所以退了";
$refund_apply_info->refund_pics="[\"\"]";
$req->setRefundApplyInfo(json_encode($refund_apply_info));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.tcls.aelophy.merchant.channel.refund.apply' \
-d 'partner_id=apidoc' \
-d 'session=d0b93d09-d865-437d-bab5-3897cc4c17ae' \
-d 'sign=14E8C26203BA485882E9ABCFEF9034CE' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-02+20%3A50%3A43' \
-d 'v=2.0' \
-d 'refund_apply_info=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaTclsAelophyMerchantChannelRefundApplyRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.refund_apply_info=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.tcls.aelophy.merchant.channel.refund.apply");
add_param(pRequest,"refund_apply_info","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.tcls.aelophy.merchant.channel.refund.apply', {
	'refund_apply_info':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_tcls_aelophy_merchant_channel_refund_apply_response>
    <api_result>
        <err_msg>成功</err_msg>
        <err_code>SUCCESS</err_code>
        <success>true</success>
    </api_result>
</alibaba_tcls_aelophy_merchant_channel_refund_apply_response>

{
    "alibaba_tcls_aelophy_merchant_channel_refund_apply_response":{
        "api_result":{
            "err_msg":"成功",
            "err_code":"SUCCESS",
            "success":true
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

五道口API

alibaba.tcls.aelophy.merchant.channel.refund.apply (翱象商家自有渠道逆向单申请)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈

五道口API

alibaba.tcls.aelophy.merchant.channel.refund.apply (翱象商家自有渠道 逆向单申请)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈

alibaba.tcls.aelophy.merchant.channel.refund.apply (翱象商家自有渠道逆向单申请)