j9九游会登录/ 云商店/ / / / / / 更新授权码有效期(可选)
更新时间:2025-04-25 gmt 08:00

更新授权码有效期(可选)-j9九游会登录

接口说明

包周期license商品实现续费、退续费场景下,商家通过该接口更新对应授权码有效期。

  • 用户续费下单,云商店将调用该接口请求商家执行业务延期,商家接口需要更新到期日,并返回通知云商店。
  • 商家需要保障接口通畅,执行业务延期,如续费失败,可能导致该授权码对应的资源被释放。
  • 针对续费场景接口调用失败的情况,云商店会持续调用60次(每2分钟1次)后停止调用,重试频率为2分钟一次,“卖家中心>生产接口消息”中可查询接口“异常信息”。商家修复接口异常后,在云商店对该失败调用进行重新调用。
  • 请注意查看商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件后及时处理接口异常。
  • 云商店会对接口异常的情况做监控,如license商品频繁出现接口异常的情况,云商店将对该商品做下架处理。

商品续费流程如下图所示:

流程说明如下:

  1. license类商品续费或退续费;
  2. 云商店调用商家服务器更新授权码有效期接口;
  3. 授权码对应的资源延期或退续期,更新资源到期日;
  4. 返回更新授权码有效期结果。

请求消息

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

请求方法:post

参数

是否必选

类型

最大字符长度

说明

activity

m

string

20

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

续费场景取值:refreshlicensecode

scene

m

string

64

场景,触发授权码变更的场景:

renewal:续费

unsubscribe_renewal_period:退续费"

orderid

m

string

64

云商店订单id

说明:

续费或退续费操作会产生新的订单id,与新购或续费时订单id不一致。

orderlineid

m

string

64

云商店订单行id。

license

m

string

64

授权码。

productid

o

string

64

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

expiretime

m

string

20

过期时间。

格式:yyyymmddhhmmss

testflag

o

string

2

是否为调试请求。

  • 1:调试请求
  • 0:非调试请求

默认取值为“0”。

请求消息示例:

{
"activity":"refreshlicensecode",
"expiretime":"20230523201932",
"license":"******",
"orderid":"******",
"orderlineid":"******",
"productid":"******",
"scene":"renewal",
"testflag":"1"
}

响应消息

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

参数

是否必选

类型

最大字符长度

说明

resultcode

m

string

6

调用结果码。

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

resultmsg

o

string

255

调用结果描述。

响应消息示例:

{ 
    "resultcode":"000000", 
    "resultmsg":"success." 
}

相关文档

网站地图