释放授权码
接口说明
用户购买的商品过期并超过保留期后,云商店调用该接口,商家接到该通知以后应该将授权码对应的资源释放。
- 云商店调用该接口时,商家需要保障接口通畅,对该授权码对应的资源进行释放,如释放失败,可能导致用户仍可使用该资源。
- 针对商品过期且未续费的场景下,接口调用失败的情况,云商店会持续调用60次(每2分钟1次)后停止调用,重试频率为2分钟一次,“卖家中心>生产接口消息”中可查询接口“异常信息”。商家修复接口异常后,在云商店对该失败调用进行重新调用。
- 请注意查看商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。
- 云商店会对接口异常的情况做监控,如License商品频繁出现接口异常的情况,云商店将对该商品做下架处理。
商品释放流程如下图所示:
流程说明如下:
- License类商品到期不续订且超过保留期或退订成功。
- 调用释放授权码接口。
- 释放授权码对应的资源。
- 返回释放授权码结果。
请求消息
请求参数说明请参见下表:
请求方法:POST
参数 |
是否必选 |
类型 |
最大字符长度 |
说明 |
---|---|---|---|---|
activity |
M |
String |
32 |
接口请求标识,用于区分接口请求场景。 释放场景取值:releaseLicenseCode |
license |
M |
String |
64 |
授权码 |
orderId |
O |
String |
64 |
退订商品触发的释放授权码场景下会传递退订订单 |
orderLineId |
O |
String |
64 |
云商店订单行ID。 |
testFlag |
O |
String |
2 |
是否为调试请求。
默认取值为“0”。 |
请求消息示例:
{ "activity":"releaseLicenseCode", "license":"*******", "orderId":"******", "orderLineId":"******", "testFlag":"1" }
响应消息
响应参数说明请参见下表:
参数 |
是否必选 |
类型 |
最大字符长度 |
说明 |
---|---|---|---|---|
resultCode |
M |
String |
6 |
调用结果码。 具体请参见调用结果码说明。 |
resultMsg |
O |
String |
255 |
调用结果描述。 |
响应消息示例:
{ "resultCode":"000000", "resultMsg":"success." }