更新授权码有效期
接口说明
包周期License商品实现续费、退续费场景下,商家通过该接口更新对应授权码有效期。
- 用户续费下单,云商店将调用该接口请求商家执行业务延期,商家接口需要更新到期日,并返回通知云商店。
- 商家需要保障接口通畅,执行业务延期,如续费失败,可能导致该授权码对应的资源被释放。
- 针对续费场景接口调用失败的情况,云商店会持续调用60次(每2分钟1次)后停止调用,重试频率为2分钟一次,“卖家中心>生产接口消息”中可查询接口“异常信息”。商家修复接口异常后,在云商店对该失败调用进行重新调用。
![](https://support.huaweicloud.com/accessg-marketplace/public_sys-resources/note_3.0-zh-cn.png)
- 请注意查看商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件后及时处理接口异常。
- 云商店会对接口异常的情况做监控,如License商品频繁出现接口异常的情况,云商店将对该商品做下架处理。
商品续费流程如下图所示:
流程说明如下:
- License类商品续费或退续费;
- 云商店调用商家服务器更新授权码有效期接口;
- 授权码对应的资源延期或退续期,更新资源到期日;
- 返回更新授权码有效期结果。
请求消息
请求参数说明请参见下表:
请求方法: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 |
是否为调试请求。
默认取值为“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." }