本文导读

展开导读

文档首页/ 云商店/ 接入指南/ SaaS类商品接入指南V1.0（存量商品）/ 接口描述/ 商品资源释放

商品资源释放

更新时间：2024-10-11 GMT+08:00

查看PDF

接口说明

云商店将在释放客户购买的商品时调用该接口，服务商接收到该通知以后可以删除指定的实例。
当客户已购买的商品到期不续订且超过保留期、或申请退订商品成功时，客户不进行续费等操作，将释放客户购买的商品资源。
针对释放场景接口调用失败的情况，云商店会持续调用1个小时后停止调用，“Application Tools > Service Interface Messages”中可查询接口“异常信息”。若服务商接口问题在1个小时内解决，则在下一次调用时接口响应成功；若服务商接口问题在1个小时后仍无解决，系统停止调用，请在修复接口异常后，在“Application Tools > Service Interface Messages”该订单记录的右侧点击“Restart Debugging”，进行接口的重新调用。
说明：
- 请及时关注云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
- 云商店会对接口异常的情况做监控，如SaaS商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。

商品资源释放流程如下图所示：

点击放大

请求消息

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

请求方法：GET

参数	是否必选	类型	最大字符长度	说明
activity	M	String	20	接口请求标识，用于区分接口请求场景。释放场景取值：releaseInstance
instanceId	M	String	64	实例ID。
orderId	M	String	64	新购商品时对应的订单ID。
testFlag	O	String	2	是否为调试请求。 1：调试请求 0：非调试请求默认取值为“0”。
authToken	M	String	50	安全校验令牌。取值请参见authToken取值说明。
timeStamp	M	String	20	请求发起时的时间戳，取UTC时间。格式：yyyyMMddHHmmssSSS
orderAmount	O	bigdecimal	20	订单金额。说明：该金额为用户实际支付金额，供服务商对账参考。金额值大于等于0，最大三位小数。单位：美元

请求消息示例：

https://isvserver.com/produceAPI?activity=releaseInstance&instanceId=03pf80c2bae96vc49b80b917bea776d7 &timeStamp=20170725025113409&testFlag=0&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

响应消息

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

参数	是否必选	类型	最大字符长度	说明
resultCode	M	String	6	调用结果码。具体请参见调用结果码说明。
resultMsg	O	String	255	调用结果描述。

参数

是否必选

类型

最大字符长度

说明

resultCode

String

调用结果码。

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

resultMsg

String

255

调用结果描述。

说明：

服务商的服务器在处理接口请求时，需要做好幂等性处理。
云商店服务有可能重发请求，针对同一instanceId，服务商的服务器不应该重复做实例资源释放处理，返回成功响应即可。

响应消息示例：

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

父主题： 接口描述

上一篇：商品过期

下一篇：商品升级

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消