淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
card_renewal_promo	CardRenewalPromo	必须
└ cinema_link_id String 必须 888889 影院内码 └ next_renewal_time Date 必须 2023-08-20 00:00:00 下次续费时间 └ price Number 必须 100 续费金额 └ lease_code String 必须 schjyzzh 租户编码 └ auto_renewal Boolean 可选 false 是否是自动续费 └ card_no String 必须 20002283877X 卡号

名称	类型	示例值	描述
data	Json	{ "innerCode": "LARK-F141-001-4-B001", "data": { "cardRenewalActivityInfo": { "channelTypeDesc": "不限", "modifiedTime": 1692260101000, "renewalPromotionRuleInfo": { "orderType": "GOODS", "countOfFreeOrder": 2, "channelCodes": [ "MYWH_DDY_OPEN", "POS_888888", "POS_888889", "SCHJYZZH_ANDROID_PROD_APP", "SCHJYZZH_H5_PROD_S_MPS", "SCHJYZZH_IOS_PROD_APP", "SCHJYZZH_OPEN", "SCHJYZZH_WEB_PROD_S_MPS", "SCHJYZZH_WX_APPLET_TPP", "SCHJYZZH_WX_MP_LARK", "SCHJYZZH_WX_PROD_APPLET_TPP", "schjyzzh_H5" ] }, "bizType": "CARD", "modifiedUser": "schjyzzh_pannan", "channelType": "DEFAULT", "activityDesc": "测试一下", "activityCode": "u7rbroi6gcad", "bizTypeDesc": "会员卡", "cardRuleIds": [ "10000165" ], "promoTypeDesc": "续费活动", "availablePeriods": null, "paymentMethods": null, "activityIntro": null, "activityTag": "免首期会费，满2单下次续费", "startTime": 1692201600000, "auditOpinion": null, "promoType": "CARD_RENEW_ACTIVITY", "activityName": "测试算价1", "cinemaLinkIds": [ "888889" ], "activityTypeDesc": "会员卡活动", "opers": [ "DISABLE", "TOP", "LOG", "HISTORY", "DETAIL" ], "createTime": 1692252049000, "firstOrderPromotion": "NORMAL_CHARGE", "auditUser": "schjyzzh_pannan", "leaseCode": "schjyzzh", "createUser": "schjyzzh_pannan", "endTime": 1693411200000, "activityType": "CARD_RENEWAL", "channelCodes": null, "status": "RUNNING" }, "originalPrice": 100, "userPay": 100, "countOfOrder": null, "promotion": 0 }, "success": true, "resultCode": "SUCCESS", "resultMsg": "操作成功" }	计算会员卡续费营销价格接口返回数据，该API不涉及到敏感数据

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LarkPosOrderCardrenewalpromocalculateRequest req = new LarkPosOrderCardrenewalpromocalculateRequest();
LarkPosOrderCardrenewalpromocalculateRequest.CardRenewalPromo obj1 = new LarkPosOrderCardrenewalpromocalculateRequest.CardRenewalPromo();
obj1.setCinemaLinkId("888889");
obj1.setNextRenewalTime(StringUtils.parseDateTime("2023-08-20 00:00:00"));
obj1.setPrice(100L);
obj1.setLeaseCode("schjyzzh");
obj1.setAutoRenewal(false);
obj1.setCardNo("20002283877X");
req.setCardRenewalPromo(obj1);
LarkPosOrderCardrenewalpromocalculateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
LarkPosOrderCardrenewalpromocalculateRequest req = new LarkPosOrderCardrenewalpromocalculateRequest();
LarkPosOrderCardrenewalpromocalculateRequest.CardRenewalPromoDomain obj1 = new LarkPosOrderCardrenewalpromocalculateRequest.CardRenewalPromoDomain();
obj1.CinemaLinkId = "888889";
obj1.NextRenewalTime = DateTime.Parse(2023-08-20 00:00:00");
obj1.Price = 100L;
obj1.LeaseCode = "schjyzzh";
obj1.AutoRenewal = false;
obj1.CardNo = "20002283877X";
req.CardRenewalPromo_ = obj1;
LarkPosOrderCardrenewalpromocalculateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new LarkPosOrderCardrenewalpromocalculateRequest;
$card_renewal_promo = new CardRenewalPromo;
$card_renewal_promo->cinema_link_id="888889";
$card_renewal_promo->next_renewal_time="2023-08-20 00:00:00";
$card_renewal_promo->price="100";
$card_renewal_promo->lease_code="schjyzzh";
$card_renewal_promo->auto_renewal="false";
$card_renewal_promo->card_no="20002283877X";
$req->setCardRenewalPromo(json_encode($card_renewal_promo));
$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=taobao.lark.pos.order.cardrenewalpromocalculate' \
-d 'partner_id=apidoc' \
-d 'sign=C167DE47319BCF391BE761CCE8C2A0FA' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-23+18%3A44%3A22' \
-d 'v=2.0' \
-d 'card_renewal_promo=null'

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

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

req.card_renewal_promo="数据结构示例JSON格式"
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,"taobao.lark.pos.order.cardrenewalpromocalculate");
add_param(pRequest,"card_renewal_promo","数据结构JSON示例");
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('taobao.lark.pos.order.cardrenewalpromocalculate', {
	'card_renewal_promo':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<lark_pos_order_cardrenewalpromocalculate_response>
    <data>{   &quot;innerCode&quot;: &quot;LARK-F141-001-4-B001&quot;,   &quot;data&quot;: {     &quot;cardRenewalActivityInfo&quot;: {       &quot;channelTypeDesc&quot;: &quot;不限&quot;,       &quot;modifiedTime&quot;: 1692260101000,       &quot;renewalPromotionRuleInfo&quot;: {         &quot;orderType&quot;: &quot;GOODS&quot;,         &quot;countOfFreeOrder&quot;: 2,         &quot;channelCodes&quot;: [           &quot;MYWH_DDY_OPEN&quot;,           &quot;POS_888888&quot;,           &quot;POS_888889&quot;,           &quot;SCHJYZZH_ANDROID_PROD_APP&quot;,           &quot;SCHJYZZH_H5_PROD_S_MPS&quot;,           &quot;SCHJYZZH_IOS_PROD_APP&quot;,           &quot;SCHJYZZH_OPEN&quot;,           &quot;SCHJYZZH_WEB_PROD_S_MPS&quot;,           &quot;SCHJYZZH_WX_APPLET_TPP&quot;,           &quot;SCHJYZZH_WX_MP_LARK&quot;,           &quot;SCHJYZZH_WX_PROD_APPLET_TPP&quot;,           &quot;schjyzzh_H5&quot;         ]       },       &quot;bizType&quot;: &quot;CARD&quot;,       &quot;modifiedUser&quot;: &quot;schjyzzh_pannan&quot;,       &quot;channelType&quot;: &quot;DEFAULT&quot;,       &quot;activityDesc&quot;: &quot;测试一下&quot;,       &quot;activityCode&quot;: &quot;u7rbroi6gcad&quot;,       &quot;bizTypeDesc&quot;: &quot;会员卡&quot;,       &quot;cardRuleIds&quot;: [         &quot;10000165&quot;       ],       &quot;promoTypeDesc&quot;: &quot;续费活动&quot;,       &quot;availablePeriods&quot;: null,       &quot;paymentMethods&quot;: null,       &quot;activityIntro&quot;: null,       &quot;activityTag&quot;: &quot;免首期会费，满2单下次续费&quot;,       &quot;startTime&quot;: 1692201600000,       &quot;auditOpinion&quot;: null,       &quot;promoType&quot;: &quot;CARD_RENEW_ACTIVITY&quot;,       &quot;activityName&quot;: &quot;测试算价1&quot;,       &quot;cinemaLinkIds&quot;: [         &quot;888889&quot;       ],       &quot;activityTypeDesc&quot;: &quot;会员卡活动&quot;,       &quot;opers&quot;: [         &quot;DISABLE&quot;,         &quot;TOP&quot;,         &quot;LOG&quot;,         &quot;HISTORY&quot;,         &quot;DETAIL&quot;       ],       &quot;createTime&quot;: 1692252049000,       &quot;firstOrderPromotion&quot;: &quot;NORMAL_CHARGE&quot;,       &quot;auditUser&quot;: &quot;schjyzzh_pannan&quot;,       &quot;leaseCode&quot;: &quot;schjyzzh&quot;,       &quot;createUser&quot;: &quot;schjyzzh_pannan&quot;,       &quot;endTime&quot;: 1693411200000,       &quot;activityType&quot;: &quot;CARD_RENEWAL&quot;,       &quot;channelCodes&quot;: null,       &quot;status&quot;: &quot;RUNNING&quot;     },     &quot;originalPrice&quot;: 100,     &quot;userPay&quot;: 100,     &quot;countOfOrder&quot;: null,     &quot;promotion&quot;: 0   },   &quot;success&quot;: true,   &quot;resultCode&quot;: &quot;SUCCESS&quot;,   &quot;resultMsg&quot;: &quot;操作成功&quot; }</data>
</lark_pos_order_cardrenewalpromocalculate_response>

{
    "lark_pos_order_cardrenewalpromocalculate_response":{
        "data":"{   \"innerCode\": \"LARK-F141-001-4-B001\",   \"data\": {     \"cardRenewalActivityInfo\": {       \"channelTypeDesc\": \"不限\",       \"modifiedTime\": 1692260101000,       \"renewalPromotionRuleInfo\": {         \"orderType\": \"GOODS\",         \"countOfFreeOrder\": 2,         \"channelCodes\": [           \"MYWH_DDY_OPEN\",           \"POS_888888\",           \"POS_888889\",           \"SCHJYZZH_ANDROID_PROD_APP\",           \"SCHJYZZH_H5_PROD_S_MPS\",           \"SCHJYZZH_IOS_PROD_APP\",           \"SCHJYZZH_OPEN\",           \"SCHJYZZH_WEB_PROD_S_MPS\",           \"SCHJYZZH_WX_APPLET_TPP\",           \"SCHJYZZH_WX_MP_LARK\",           \"SCHJYZZH_WX_PROD_APPLET_TPP\",           \"schjyzzh_H5\"         ]       },       \"bizType\": \"CARD\",       \"modifiedUser\": \"schjyzzh_pannan\",       \"channelType\": \"DEFAULT\",       \"activityDesc\": \"测试一下\",       \"activityCode\": \"u7rbroi6gcad\",       \"bizTypeDesc\": \"会员卡\",       \"cardRuleIds\": [         \"10000165\"       ],       \"promoTypeDesc\": \"续费活动\",       \"availablePeriods\": null,       \"paymentMethods\": null,       \"activityIntro\": null,       \"activityTag\": \"免首期会费，满2单下次续费\",       \"startTime\": 1692201600000,       \"auditOpinion\": null,       \"promoType\": \"CARD_RENEW_ACTIVITY\",       \"activityName\": \"测试算价1\",       \"cinemaLinkIds\": [         \"888889\"       ],       \"activityTypeDesc\": \"会员卡活动\",       \"opers\": [         \"DISABLE\",         \"TOP\",         \"LOG\",         \"HISTORY\",         \"DETAIL\"       ],       \"createTime\": 1692252049000,       \"firstOrderPromotion\": \"NORMAL_CHARGE\",       \"auditUser\": \"schjyzzh_pannan\",       \"leaseCode\": \"schjyzzh\",       \"createUser\": \"schjyzzh_pannan\",       \"endTime\": 1693411200000,       \"activityType\": \"CARD_RENEWAL\",       \"channelCodes\": null,       \"status\": \"RUNNING\"     },     \"originalPrice\": 100,     \"userPay\": 100,     \"countOfOrder\": null,     \"promotion\": 0   },   \"success\": true,   \"resultCode\": \"SUCCESS\",   \"resultMsg\": \"操作成功\" }"
    }
}

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

taobao.lark.pos.order.cardrenewalpromocalculate (续费算价接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ