更新时间:2023-10-13 GMT+08:00
分享

释放授权码

接口说明

用户购买的商品过期并超过保留期后,云商店调用该接口,商家接到该通知以后应该将授权码对应的资源释放。

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

商品释放流程如下图所示:

流程说明如下:

  1. License类商品到期不续订且超过保留期或退订成功。
  2. 调用释放授权码接口。
  3. 释放授权码对应的资源。
  4. 返回释放授权码结果。

请求消息

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

请求方法:POST

参数

是否必选

类型

最大字符长度

说明

activity

M

String

32

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

释放场景取值:releaseLicenseCode

license

M

String

64

授权码

orderId

O

String

64

退订商品触发的释放授权码场景下会传递退订订单

orderLineId

O

String

64

云商店订单行ID。

testFlag

O

String

2

是否为调试请求。

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

默认取值为“0”。

请求消息示例:

{
"activity":"releaseLicenseCode",
"license":"*******",
"orderId":"******",
"orderLineId":"******",
"testFlag":"1"
}

响应消息

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

参数

是否必选

类型

最大字符长度

说明

resultCode

M

String

6

调用结果码。

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

resultMsg

O

String

255

调用结果描述。

响应消息示例:

{ 
    "resultCode":"000000", 
    "resultMsg":"success." 
}

相关文档