j9九游会登录/ 云商店/ / / / / / 商品升级
更新时间：2025-11-13 gmt 08:00

商品升级-j9九游会登录

接口说明

  • 用户对已购买的商品进行升级（升配&扩容），升级订单付款成功后，云商店调用该接口请求商家升级用户购买的商品，商家接口需要执行商品升级，并返回通知云商店。
  • 针对升级场景接口调用失败的情况，云商店会持续调用3小时后停止调用，期间商家可在“”页面单击对应订单右侧操作栏的“重新启动”进行手动重试。若商家接口问题在3小时调用时间内解决，则在下一次调用接口响应成功，订单开通成功；若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。
    • 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
    • 云商店会对接口异常的情况做监控，如saas商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。
  • 商品升级规则设置参考 。

商品升级流程如下图所示：

请求消息

请求参数说明请参见下表：

请求方法：get

参数

是否必选

类型

最大字符长度

说明

authtoken

m

string

50

安全校验令牌。

取值请参见authtoken取值说明。

activity

m

string

20

接口请求标识，用于区分接口请求场景。

升级场景取值：upgrade

instanceid

m

string

64

实例id。

说明：

升级时，instanceid不变。

orderid

m

string

64

升级后的新订单id。

说明：

升级操作会产生新的订单，与新购时订单id不一致，请通过instance id做资源识别。

skucode

m

string

64

升级后产品规格标识。

说明：

对于自定义属性模板规格，如果租户升级时选择了其他属性值，instanceid对应的规格会发生变化，因此skucode会变化；

如果仅扩容（调整增加线性属性值大小，例如：从当前的10用户增加到20用户），skucode不变。

productid

m

string

64

升级后产品id。

如果skucode变化，productid也会发生变化；

如果仅扩容，productid不变。

timestamp

m

string

20

请求发起时的时间戳，取utc时间。

格式：yyyymmddhhmmsssss

amount

o

integer

7

数量类型的商品定价属性。非必填。

属性名称：数量（支持商家自定义名称）

单位：个（次）

说明：

升级后的数量，对于包周期或一次性计费的saas商品，租户下单购买包含“数量”线性属性的规格时，会填写及调整购买的个数或次数。

例如：30个用户

disksize

o

integer

7

数量类型的商品定价属性。非必填。

属性名称：硬盘大小（支持商家自定义名称）

单位：gb

说明：

对于包周期或一次性计费的saas商品，租户下单购买包含“硬盘大小”线性属性的规格时，会填写及调整购买多少gb。

例如：100gb

bandwidth

o

integer

7

数量类型的商品定价属性。非必填。

属性名称：带宽（支持商家自定义名称）

单位：mbps

说明：

对于包周期或一次性计费的saas商品，租户下单购买包含“带宽”线性属性的规格时，会填写及调整购买多少mbps。

例如：20mbps

testflag

o

integer

1

是否调测数据。

  • 1：接口调测数据
  • 不传参数：真实买家同步数据

请求消息示例：

https://example.isv.com?activity=upgrade&amount=6456&instanceid=huaweitest123456&orderid=cs1906666688abcde&productid=00301-666688-0-0&saasextendparams=w3sibmftzsi6imlktnvtiiwidmfsdwuioiizntiyntu1ntu1ntu2ntyifsx7im5hbwuioij1c2vytmftzsisinzhbhvlijoiahvhd2vpmtizin0seyjuyw1lijoiy3vzdevtywlsiiwidmfsdwuioiixmjnaahvhd2vplmnvbsj9xq==&skucode=d0abcd12-1234-5678-ab90-11ab012aaaa1&testflag=1&timestamp=20191216013757582&authtoken=a3bl c93xv3engm40ngyyvqnycts/pgy5ugl20wtzgg=

响应消息

响应参数说明请参见下表：

参数

是否必选

类型

最大字符长度

说明

resultcode

m

string

6

调用结果码。

具体请参见调用结果码说明。

resultmsg

o

string

255

调用结果描述。

商家的服务器在处理接口请求时，需要做好幂等性处理。

云商店服务有可能重发请求，针对同一orderid，商家的服务器不应该重复做实例资源升级处理，返回成功响应即可。

响应消息示例：

{
    "resultcode":"000000",
    "resultmsg":"success."
}
父主题：

相关文档

网站地图