淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	描述
repaid_interest	String	可选	135.94	已还利息
repaid_penalty	String	可选	0.00	违约金
repaid_total_amount	String	可选	9637.94	总金额
repaid_time	Date	可选	2022-03-04 09:22:15	还款时间
repay_apply_no	String	可选	FI990100029039025030400000194231	还款单号
repaid_principal	String	可选	9500.00	还款本金
repay_loan_detail_list	RepayLoanDetail	可选		还款明细
└ repaid_interest String 可选 135.94 利息 └ institution_repayment_detail_no String 可选 2025030410199318530105000000590037675558 业务方内部单号 └ repaid_penalty String 可选 0.00 违约金 └ repaid_total_amount String 可选 9635.94 总金额 └ repaid_principal String 可选 9500.00 本金 └ loan_apply_no String 可选 FI990100027039025020500000160021 借款单据
repay_status	String	可选	SUCCESS	还款结果
request_id	String	可选	2025030410199318530105010000590037675557_S	请求id
institution_repayment_no	String	可选	2025030410199318530105010000590037675557	服务商内部还款单号
repay_initiator	String	可选	ALI	还款发起人
customer_id	String	可选	234gfh5	用户id
fail_reason_code	String	可选	CODE	错误码
fail_reason_message	String	可选	风控拒绝	授信失败原因

名称	类型	示例值	描述
trace_id	String	2150433817410518168866371e13dd	traceId
result_code	String	SUCCESS	错误码
result	Boolean	true	返回结果

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFinanceZhixinRepayNotifyRequest req = new AlitripFinanceZhixinRepayNotifyRequest();
req.setRepaidInterest("135.94");
req.setRepaidPenalty("0.00");
req.setRepaidTotalAmount("9637.94");
req.setRepaidTime(StringUtils.parseDateTime("2022-03-04 09:22:15"));
req.setRepayApplyNo("FI990100029039025030400000194231");
req.setRepaidPrincipal("9500.00");
AlitripFinanceZhixinRepayNotifyRequest.RepayLoanDetail obj1 = new AlitripFinanceZhixinRepayNotifyRequest.RepayLoanDetail();
obj1.setRepaidInterest("135.94");
obj1.setInstitutionRepaymentDetailNo("2025030410199318530105000000590037675558");
obj1.setRepaidPenalty("0.00");
obj1.setRepaidTotalAmount("9635.94");
obj1.setRepaidPrincipal("9500.00");
obj1.setLoanApplyNo("FI990100027039025020500000160021");
req.setRepayLoanDetailList(obj1);
req.setRepayStatus("SUCCESS");
req.setRequestId("2025030410199318530105010000590037675557_S");
req.setInstitutionRepaymentNo("2025030410199318530105010000590037675557");
req.setRepayInitiator("ALI");
req.setCustomerId("234gfh5");
req.setFailReasonCode("CODE");
req.setFailReasonMessage("风控拒绝");
AlitripFinanceZhixinRepayNotifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripFinanceZhixinRepayNotifyRequest req = new AlitripFinanceZhixinRepayNotifyRequest();
req.RepaidInterest = "135.94";
req.RepaidPenalty = "0.00";
req.RepaidTotalAmount = "9637.94";
req.RepaidTime = DateTime.Parse("2022-03-04 09:22:15");
req.RepayApplyNo = "FI990100029039025030400000194231";
req.RepaidPrincipal = "9500.00";
AlitripFinanceZhixinRepayNotifyRequest.RepayLoanDetailDomain obj1 = new AlitripFinanceZhixinRepayNotifyRequest.RepayLoanDetailDomain();
obj1.RepaidInterest = "135.94";
obj1.InstitutionRepaymentDetailNo = "2025030410199318530105000000590037675558";
obj1.RepaidPenalty = "0.00";
obj1.RepaidTotalAmount = "9635.94";
obj1.RepaidPrincipal = "9500.00";
obj1.LoanApplyNo = "FI990100027039025020500000160021";
req.RepayLoanDetailList_ = obj1;
req.RepayStatus = "SUCCESS";
req.RequestId = "2025030410199318530105010000590037675557_S";
req.InstitutionRepaymentNo = "2025030410199318530105010000590037675557";
req.RepayInitiator = "ALI";
req.CustomerId = "234gfh5";
req.FailReasonCode = "CODE";
req.FailReasonMessage = "风控拒绝";
AlitripFinanceZhixinRepayNotifyResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripFinanceZhixinRepayNotifyRequest;
$req->setRepaidInterest("135.94");
$req->setRepaidPenalty("0.00");
$req->setRepaidTotalAmount("9637.94");
$req->setRepaidTime("2022-03-04 09:22:15");
$req->setRepayApplyNo("FI990100029039025030400000194231");
$req->setRepaidPrincipal("9500.00");
$repay_loan_detail_list = new RepayLoanDetail;
$repay_loan_detail_list->repaid_interest="135.94";
$repay_loan_detail_list->institution_repayment_detail_no="2025030410199318530105000000590037675558";
$repay_loan_detail_list->repaid_penalty="0.00";
$repay_loan_detail_list->repaid_total_amount="9635.94";
$repay_loan_detail_list->repaid_principal="9500.00";
$repay_loan_detail_list->loan_apply_no="FI990100027039025020500000160021";
$req->setRepayLoanDetailList(json_encode($repay_loan_detail_list));
$req->setRepayStatus("SUCCESS");
$req->setRequestId("2025030410199318530105010000590037675557_S");
$req->setInstitutionRepaymentNo("2025030410199318530105010000590037675557");
$req->setRepayInitiator("ALI");
$req->setCustomerId("234gfh5");
$req->setFailReasonCode("CODE");
$req->setFailReasonMessage("风控拒绝");
$resp = $c->execute($req);

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=alitrip.finance.zhixin.repay.notify' \
-d 'partner_id=apidoc' \
-d 'sign=0AD9BED130A52711BCD67A697DAADB24' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-15+18%3A44%3A40' \
-d 'v=2.0' \
-d 'customer_id=234gfh5' \
-d 'fail_reason_code=CODE' \
-d 'fail_reason_message=%E9%A3%8E%E6%8E%A7%E6%8B%92%E7%BB%9D' \
-d 'institution_repayment_no=2025030410199318530105010000590037675557' \
-d 'repaid_interest=135.94' \
-d 'repaid_penalty=0.00' \
-d 'repaid_principal=9500.00' \
-d 'repaid_time=2022-03-04+09%3A22%3A15' \
-d 'repaid_total_amount=9637.94' \
-d 'repay_apply_no=FI990100029039025030400000194231' \
-d 'repay_initiator=ALI' \
-d 'repay_loan_detail_list=null' \
-d 'repay_status=SUCCESS' \
-d 'request_id=2025030410199318530105010000590037675557_S'

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

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

req.repaid_interest="135.94"
req.repaid_penalty="0.00"
req.repaid_total_amount="9637.94"
req.repaid_time="2022-03-04 09:22:15"
req.repay_apply_no="FI990100029039025030400000194231"
req.repaid_principal="9500.00"
req.repay_loan_detail_list="[]"
req.repay_status="SUCCESS"
req.request_id="2025030410199318530105010000590037675557_S"
req.institution_repayment_no="2025030410199318530105010000590037675557"
req.repay_initiator="ALI"
req.customer_id="234gfh5"
req.fail_reason_code="CODE"
req.fail_reason_message="风控拒绝"
try:
	resp= req.getResponse()
	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,"alitrip.finance.zhixin.repay.notify");
add_param(pRequest,"repaid_interest","135.94");
add_param(pRequest,"repaid_penalty","0.00");
add_param(pRequest,"repaid_total_amount","9637.94");
add_param(pRequest,"repaid_time","2022-03-04 09:22:15");
add_param(pRequest,"repay_apply_no","FI990100029039025030400000194231");
add_param(pRequest,"repaid_principal","9500.00");
add_param(pRequest,"repay_loan_detail_list","数据结构JSON示例");
add_param(pRequest,"repay_status","SUCCESS");
add_param(pRequest,"request_id","2025030410199318530105010000590037675557_S");
add_param(pRequest,"institution_repayment_no","2025030410199318530105010000590037675557");
add_param(pRequest,"repay_initiator","ALI");
add_param(pRequest,"customer_id","234gfh5");
add_param(pRequest,"fail_reason_code","CODE");
add_param(pRequest,"fail_reason_message","风控拒绝");
pResponse = top_execute(pClient,pRequest,NULL);
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('alitrip.finance.zhixin.repay.notify', {
	'repaid_interest':'135.94',
	'repaid_penalty':'0.00',
	'repaid_total_amount':'9637.94',
	'repaid_time':'2022-03-04 09:22:15',
	'repay_apply_no':'FI990100029039025030400000194231',
	'repaid_principal':'9500.00',
	'repay_loan_detail_list':'数据结构JSON示例',
	'repay_status':'SUCCESS',
	'request_id':'2025030410199318530105010000590037675557_S',
	'institution_repayment_no':'2025030410199318530105010000590037675557',
	'repay_initiator':'ALI',
	'customer_id':'234gfh5',
	'fail_reason_code':'CODE',
	'fail_reason_message':'风控拒绝'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_finance_zhixin_repay_notify_response>
    <trace_id>2150433817410518168866371e13dd</trace_id>
    <result_code>SUCCESS</result_code>
    <result>true</result>
</alitrip_finance_zhixin_repay_notify_response>

{
    "alitrip_finance_zhixin_repay_notify_response":{
        "trace_id":"2150433817410518168866371e13dd",
        "result_code":"SUCCESS",
        "result":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

alitrip.finance.zhixin.repay.notify (智信异步还款通知)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ