云商店-商品续费:请求方法:GET
请求方法:GET
参数 |
是否必选 |
类型 |
最大字符长度 |
说明 |
---|---|---|---|---|
activity |
M |
String |
20 |
接口请求标识,用于区分接口请求场景。 续费场景取值:refreshInstance |
authToken |
M |
String |
50 |
安全校验令牌。 取值请参见authToken取值说明。 |
orderId |
M |
String |
64 |
云商店订单ID。
说明:
续费、退续费操作会产生新的订单,与新购时订单ID不一致,请通过instance Id做资源识别。 |
instanceId |
M |
String |
64 |
实例ID。 |
productId |
O |
String |
64 |
产品标识,租户续费或转正产品实例时,如果订购周期类型发生变化,会传入变化后的产品类型对应的productId。 |
expireTime |
M |
String |
20 |
过期时间。 格式:yyyyMMddHHmmss |
trialToFormal |
O |
String |
2 |
是否是试用转正请求
默认不是试用转正。 |
timeStamp |
M |
String |
20 |
请求发起时的时间戳,取UTC时间。 格式:yyyyMMddHHmmssSSS |
periodType |
O |
String |
10 |
周期类型。
说明:
非必传,如需此参数,计费类型需选择包周期chargingMode=1,包周期购买场景请求时传该参数 年:"year" 月:"month" chargingMode=3,按次数购买场景请求时不传该参数。 |
periodNumber |
O |
integer |
2 |
周期数量。
说明:
非必传,如需此参数,计费类型需选择包周期chargingMode=1,包周期购买场景请求时传该参数。 周期数量:1,2,3… |
orderAmount |
O |
bigdecimal |
20 |
订单金额。
说明:
该金额为用户实际支付金额,供商家对账参考。 ① 续费场景: 金额值大于等于0,最大三位小数。 ② 退续费场景:金额值为负数,最大三位小数。 单位:元 |
testFlag |
O |
Integer |
1 |
是否调测数据。
|
2018年5月12日新增接口参数:productId和trialToFormal。
- 2018年5月12日之后发布产品或已发布成功的产品新增规格时,请填写此新参数并通过接口调试(productId为空或者填值,trialToFormal“不传参数”或为“1”都要求调试通过)。
- 2018年5月12日之前已发布成功的产品,如果不涉及免费试用变更,不要求做接口调试。
请求消息示例:
https://example.isv.com?activity=refreshInstance& expireTime=20180725000000&instanceId=03pf80c2bae96vc49b80b917bea776d7&orderId=HWS001014ED483AA1E8&timeStamp=20170725025113409&testFlag=0&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=