更新时间:2024-09-30 GMT+08:00
分享

商品资源释放

接口说明

  • 云商店将在释放客户购买的商品时调用该接口,商家接收到该通知以后可以删除指定的实例。
  • 当客户已购买的商品到期不续订且超过保留期、或申请退订商品成功时,将释放客户购买的商品资源。
  • 针对释放场景接口调用失败的情况,云商店会持续调用1小时后停止调用,“卖家中心>生产接口消息”中可查询接口“异常信息”,请在修复接口异常后,通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”,单击右侧操作栏的“重新启动”进行手动重试。
    • 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。
    • 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因接口异常的情况,云商店将对该商品做下架处理。

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

请求消息

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

请求方法:GET

参数

是否必选

类型

最大字符长度

说明

activity

M

String

20

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

释放场景取值:releaseInstance

authToken

M

String

50

安全校验令牌。

取值请参见authToken取值说明

instanceId

M

String

64

实例ID。

orderId

M

String

64

新购商品时对应的订单ID。

authToken

M

String

50

安全校验令牌。

取值请参见authToken取值说明

timeStamp

M

String

20

请求发起时的时间戳,取UTC时间。

格式:yyyyMMddHHmmssSSS

orderAmount

O

bigdecimal

20

订单金额。

说明:

该金额为用户实际支付金额,供商家对账参考。

金额值大于等于0,最大三位小数。

单位:元

testFlag

O

Integer

1

是否调测数据。

  • 1:接口调测数据
  • 不传参数:真实买家同步数据

请求消息示例:

https://example.isv.com?activity=releaseInstance&instanceId=03pf80c2bae96vc49b80b917bea776d7&timeStamp=20170725025113409&testFlag=1&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

响应消息

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

参数

是否必选

类型

最大字符长度

说明

resultCode

M

String

6

调用结果码。

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

resultMsg

O

String

255

调用结果描述。

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

响应消息示例:

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

相关文档