j9九游会登录/ 云商店/ / / / / 更新实例
更新时间：2025-08-27 gmt 08:00

更新实例-j9九游会登录

接口说明

按周期售卖的商品，用户试用转正、续费、退续费后，云商店调用该接口，更新实例的到期日期。

  • 用户进行商品转正、续费下单或退订续费周期后，云商店将调用该接口请求商家执行业务变更，商家接口需要执行将到期日进行更新，并返回通知云商店。
  • 商家需要保障更新实例接口通畅，如调用失败，将可能导致用户的业务被释放的风险。
  • 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
  • 云商店会对接口异常的情况做监控，如saas商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。

商品更新实例流程如下图所示：

请求方法：post

body参数

参数

是否必选

类型

取值范围

说明

activity

m

string

20

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

续费场景取值：refreshinstance

scene

m

string

64

场景，触发实例变更的场景：

trial_to_formal：试用转正

renewal：续费

unsubscribe_renewal_period：退续费

renewal_change:续费变更

orderid

m

string

64

云商店订单id，

试用转正时传递转正订单id

续费时传递当前续费订单id

退续费时传递退续费订单id

orderlineid

m

string

64

云商店订单行id。

instanceid

m

string

64

实例id。

productid

o

string

64

产品标识，租户续费或转正产品实例时，如果订购周期类型发生变化，会传入变化后的产品类型对应的productid。

expiretime

m

string

20

过期时间，取utc时间。

格式：yyyymmddhhmmss

testflag

o

string

2

是否为调试请求。

  • 1：调试请求
  • 非调试请求，不传该参数。

请求消息示例：

curl -x post 'https://www.isvwebsite.com/saasproduce?signature=3f6e6652b7be26b27abfc3d11214d04bfd8d2cf8ac21603d85620174fe8de062×tamp=1680509496350&nonce=8bf8496a350e37bdb0e8956d39d433ed417c3fc9459dcffe7f03bfbf69b12085' -h 'accept:application/json' -h 'content-type:application/json;charset=utf8' -d'{"activity":"refreshinstance","expiretime":"20221124023618256","instanceid":"10e758d0-31ad-4c4b-8f1b-81d03469a10e","orderid":"cs2211181819b4lvs","orderlineid":"cs2211181819b4lvs-000001","productid":"offi461867333479178240","scene":"renewal","testflag":"1"}'

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

参数

是否必选

类型

取值范围

说明

resultcode

m

string

6

调用结果码。

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

resultmsg

o

string

255

调用结果描述。

响应消息示例：

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

相关文档

网站地图