接口功能及说明
商家发布SaaS商品时，首先需根据本接入指南，在生产接口服务器开发一个生产系统接口。
同一个商品发布时，针对不同的调用场景（新购、续费、过期、释放和升级），只需要配置一个“生产系统接口地址”。
如果发布包周期商品，接口需实现“新购”、“续费”、“过期”、“释放”四种场景的调用。如果发布按次商品，接口需实现“新购商品”和“释放”场景的调用。
“升级”场景，不做强制要求，由商家自行确定，如所发布的商品有升级场景，则需实现；如无，则忽略。
例如：https://www.isvwebsite.com/saasproduce
SaaS 1.0接口拨测规则
商家完成上架SaaS商品后，为监控接口服务的可用性和保障客户下单交易，云商店平台每天上午和下午，会对该商品接口地址的调测用例进行自动化拨测。当前接口拨测失败时，系统会邮件通知到商家云商店账号绑定的邮箱、短信、站内信，请商家及时修复接口，具体拨测规则如下：
|
商品状态 |
拨测规则 |
|
在售 |
执行 |
|
停售 |
不执行 |
|
退市 |
不执行 |
当商品的接口连续5天拨测失败，云商店运营经理会对该商品进行冻结交易并隐藏商品处理。根据《云商店商家合作管理规范》，如未及时修复接口，云商店运营有权对该商品进行下架处理。
接口功能
- 客户购买商品并付款成功，云商店将调用本接口（新购场景）通知商家客户购买商品的信息和客户信息，商品生产环境收到该请求信息，需执行新购对应动作并将执行结果返回给云商店。
用户购买商品后，在“买家中心”点击该商品的“资源详情”查询使用信息时，会实时调用接口（新购场景）进行查询，所以商家的服务器在处理接口请求时，需要做好幂等性处理。即云商店服务有可能重发请求，针对同一订单号，商家的服务器应当返回成功的响应及应用实例信息，不应该创建新的SaaS实例，返回之前成功创建的实例信息即可。
买家购买成功后，使用信息查询操作及页面展示参考SaaS类商品使用指导。
- 客户续费下单或试用商品转正付款成功后，云商店将调用该接口（续费场景）请求商家执行业务延期，商家接口需要执行将到期日进行更新，并将执行结果返回给云商店。
- 客户购买的商品过期时，云商店调用该接口（过期场景），商家接到该通知以后应该将指定的实例冻结，并将执行结果返回给云商店。
用户订单到期后，根据客户等级的不同，有最长15天的资源冻结期，冻结期内资源不可使用，但可以对此订单续费以解冻继续使用，所以商家需对SaaS商品设置15天的冻结期，并在冻结期内保留用户数据。
- 当客户已购买的商品到期不续订且超过冻结期、或申请退订商品成功时，云商店将释放客户购买的商品并调用该接口（资源释放场景），商家接收到该通知以后删除指定的实例，并将执行结果返回给云商店。
- 客户对已购买的商品升级下单且付款成功后，云商店将调用该接口（升级场景）请求商家执行升配，商家接口需要执行将商品进行升配，并将执行结果返回给云商店。升级场景为非必选场景，商家可自行确定是否需要。
接口失败场景及重试机制
- 针对新购场景接口调用失败的情况，云商店会持续调用3小时后停止调用，每次失败发送通知。期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试，若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。
- 针对续费场景接口调用失败的情况，云商店会持续调用1小时后停止调用，“卖家中心>生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。
- 针对过期（冻结、解冻、释放）场景接口调用失败的情况，云商店会持续调用1小时后停止调用，“卖家中心>生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。
- 针对升级场景接口调用失败的情况，云商店会持续调用3小时后停止调用，期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试。若商家接口问题在3小时调用时间内解决，则在下一次调用接口响应成功，订单开通成功；若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。
- SaaS接口响应失败将通过邮件、短信、站内信进行通知，请注意关注账号绑定的邮箱、手机短信及站内信的相关通知。
- 若商品单月因接口失败导致的失败订单超过5个或长时间拨测失败，云商店将对该商品下架处理。
- 因接口响应失败导致自动退订的订单，请商家及时联系用户进行沟通，避免造成用户投诉。
