文档首页/ 云商店/ 接入指南/ 商品接入相关接口/ SaaS类商品接入指南 V2.0（新商品上架）/ 基础接口描述/ 释放实例
更新时间：2025-08-06 GMT+08:00
查看PDF
分享

释放实例

接口说明

用户释放购买产品的实例时（到期不续费、退订等场景），云商店调用该接口，商家将对应的实例进行删除。

  • 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
  • 云商店会对接口异常的情况做监控，如SaaS商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。

商品过期流程如下图所示：

请求方法：POST

Body参数

参数

是否必选

类型

取值范围

说明

activity

M

String

32

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

过期场景取值：releaseInstance

instanceId

M

String

64

实例ID

orderId

O

String

64

退订商品触发的释放实例场景下会传递退订订单

orderLineId

O

String

64

云商店订单行ID。

testFlag

O

String

2

是否为调试请求。

  • 1：调试请求
  • 非调试请求，不传该参数。

请求消息示例：

curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=C4E5F264C92F737DEBECB8D27D84684F38BF01D2917880202B59027CEEFC4932&timestamp=1680509885590&nonce=A49E8F86EE5BCAFBDFD3E53F1E09A29C6D9E8DACC67382EBCDD02CD55CBBB7AE' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -d'{"activity":"releaseInstance","instanceId":"10e758d0-31ad-4c4b-8f1b-81d03469a10e","orderId":"CS2211181819B4LVS","orderLineId":"CS2211181819B4LVS-000001","testFlag":"1"}'

响应消息

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

参数

是否必选

类型

取值范围

说明

resultCode

M

String

6

调用结果码。

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

resultMsg

O

String

255

调用结果描述。
  • 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。
  • 云商店会对接口异常的情况做监控，如SaaS商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。

响应消息示例：

{ 
    "resultCode":"000000", 
    "resultMsg":"success" 
}
父主题： 基础接口描述

相关文档