检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询实例信息 接口说明 按次或包周期商品非必选调测接口，按需和按需套餐包商品必选。 用户在购买了商品后需要查询所购买的商品实例信息，对于按需商品，还需要实时返回当前用户的按需用量信息 。 用户如果购买了按需套餐包，还需要通过这个接口返回套餐包的用量信息。 查询实例信息流程如下图所示：
查询实例信息 接口说明 商家创建完资源后，云商店根据instanceId查询资源实例的信息。 查询实例信息流程如下图所示： 请求方法：POST Body参数 参数 是否必选 类型 取值范围 说明 activity M String 20 接口请求标识，用于区分接口请求场景。 升级场景取值：queryInstance
商业信息认证 商业信息认证 场景一：2022年12月1日后入驻成功 2022年12月1日后通过入驻审核的服务商，需要进行商业信息认证，认证通过才能进行商品发布与结算。 商业信息认证是指伙伴提交其用于结算涉及到的银行账号、税率等信息；商业信息认证缺失将导致在华为云系统里无法准确获取
释放实例 接口说明 用户释放购买产品的实例时（到期不续费、退订等场景），云商店调用该接口，商家将对应的实例进行删除。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知，收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控，如商品频繁出现因接口异常的情况，云商店将对该商品做下架处理。
更新授权码有效期 接口说明 包周期License商品实现续费、退续费场景下，商家通过该接口更新对应授权码有效期。 用户续费下单，云商店将调用该接口请求商家执行业务延期，商家接口需要更新到期日，并返回通知云商店。 商家需要保障接口通畅，执行业务延期，如续费失败，可能导致该授权码对应的资源被释放。
升级相关 Sdk::CheckNewVersions Sdk::UpgradeNotify 父主题： 管理在云
获取License 接口说明 客户购买商品并付款成功，云商店将调用本接口通知商家客户购买商品的信息和客户信息，商家收到该请求信息，需执行新购对应动作并将执行结果返回给云商店。 商家需要返回此订单对应的唯一实例ID（instanceId），对不同的新购订单实例ID（instance
商品销售区域配置 服务商可对商品的销售区域进行配置，只有该用户账号的注册地在商品可销售区域范围内，才可购买商品。 如：需要购买该商品的用户账号注册地为“香港”，商品必须勾选Sparkoo Technologies Hong Kong Co., Limited的“Hong Kong
创建商家优惠 创建商家优惠 商家可自行与客户协商专属商务折扣并创建Private Offer，也可接收客户服务商创建的客户需求并创建对应的Private Offer，由客户服务商获得机会点分成。 Private Offer仅限联营商品可以创建。 入口 说明 图例 直接创建 选择左
释放授权码 接口说明 用户购买的商品过期并超过保留期后，云商店调用该接口，商家接到该通知以后应该将授权码对应的资源释放。 云商店调用该接口时，商家需要保障接口通畅，对该授权码对应的资源进行释放，如释放失败，可能导致用户仍可使用该资源。 针对商品过期且未续费的场景下，接口调用失败的
authToken取值说明 定义 authToken值是云商店与商家之间进行安全校验的必选参数。云商店每次调用商家接口的参数中都会带有authToken值。 商家根据生成规则生成authToken值，并与接口中获取的authToken值进行比较。完全相同即为校验通过。 生成规则
公共响应消息头参数 表1 公共响应消息头 名称 描述 示例 Date HTTP协议标准报头。表示消息发送的时间，时间的描述格式由rfc822定义。 Mon, 12 Nov 2007 15:55:01 GMT Server HTTP协议标准报头。包含了服务器用来处理请求的软件信息。
请求认证说明 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature，并且将signature通过URL PARAMS的方式添加到URL上，商家在接收到请求后需要同样的规则对请求体进行重新计算signature，并且与云商店传递的signature相比较，完全相同即为校验通过，通过URL
创建商家优惠 创建商家优惠 商家可自行创建Private Offer并进行销售分成，也可接收客户服务商创建的客户需求并创建对应的Private Offer，由客户服务商获得销售分成。 Private Offer仅限联营商品可以创建。 入口 说明 图例 直接创建 选择左侧导航栏“销
构造请求方法 每一个请求通常由三部分组成，分别是：请求行、请求消息头、请求正文(可选)。 请求行 请求行以一个方法符号开头，以空格分开，后面跟着请求的URI和协议的版本，格式如下： Method Request-URI HTTP-Version CRLF Method：表示请求方
组织部门信息同步（增量） 接口说明 管理员被授权管理某企业后，在买家中心登录，对管理的企业执行新建、编辑、删除部门操作时，云商店调用该接口，请求商家同步该企业的组织增量变更；商家接口需要执行增量组织信息同步，保存信息，并返回通知云商店。 商家的服务器在处理接口请求时，需要做好幂等性处理。
企业同步 接口说明 买家购买联营SaaS商品后，登录到华为云买家中心控制台，将应用与企业绑定时，云商店调用该接口请求商家同步该企业的租户信息，商家接口需要执行租户同步，保存租户信息，并返回通知云商店。 针对企业同步场景接口调用失败的情况，由买家选择是否重试，并用短信或邮件的形式通知商家接口调用失败。
租户应用信息同步接口 接口说明 买家购买联营SaaS类应用后，在买家中心登录，将应用与企业绑定时，云商店调用该接口请求商家同步该企业应用的认证信息，商家接口需要执行应用同步，保存应用信息，并返回通知云商店。 针对应用同步场景接口调用失败的情况，由买家选择是否重试，并用短信或邮件的形式通知ISV商家接口调用失败。
auth Token取值说明 定义 authToken值是云商店与商家之间进行安全校验的必选参数。云商店每次调用商家接口的参数中都会带有authToken值。 商家根据生成规则生成authToken值，并与接口中获取的authToken值进行比较。完全相同即为校验通过。 生成规则
基础功能 Sdk::Init Sdk::RegisterEventRecall Sdk::ShutOut 父主题： 改造功能模块说明
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
