更新时间:2024-10-11 GMT+08:00
商品资源释放
接口说明
- 云商店将在释放客户购买的商品时调用该接口,服务商接收到该通知以后可以删除指定的实例。
- 当客户已购买的商品到期不续订且超过保留期、或申请退订商品成功时,客户不进行续费等操作,将释放客户购买的商品资源。
- 针对释放场景接口调用失败的情况,云商店会持续调用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 |
是否为调试请求。
默认取值为“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 |
调用结果描述。 |
- 服务商的服务器在处理接口请求时,需要做好幂等性处理。
- 云商店服务有可能重发请求,针对同一instanceId,服务商的服务器不应该重复做实例资源释放处理,返回成功响应即可。
响应消息示例:
{ "resultCode":"000000", "resultMsg":"success." }
父主题: 接口描述