技术对接说明
- 商家上架联营SaaS商品需要对接云商店联营账号的统一登录能力，实现统一管理企业成员信息、统一账号登录、以及不同应用的权限分配给企业成员。
- 用户购买联营SaaS商品后，华为云账号绑定邮箱和手机号将会收到邀请您授权企业成员的通知，您可以在“买家中心>我的云商店>联营服务”后台进行企业组织、人员和应用的权限管控。
- 2024年4月27日后新入驻的商家或者上架新商品，统一按照联营SaaS类商品联营KIT与技术对接方案 V2.0规范进行接口开发和调测，SaaS 2.0接口协议提供更高的安全性、可靠性、易用性。
- 历史已对接联营SaaS类商品联营KIT与技术对接方案 V1.0规范进行上架的商品，可以进行技术升级，可参考联营SaaS类商品联营KIT与技术对接方案 V2.0。
关于买家如何完成应用的购买与配置，请参考《联营账号快捷开通流程》。
技术对接流程
001接口开发：商家上架SaaS商品需要根据不同售卖方式对接平台要求的接口，可参考接口文档接口安全令牌、基础接口描述、账号同步接口描述进行开发。
002接口调试：商家完成接口开发后，需要在卖家中心进行调试，确认接口可正常调用，可参考基础、账号同步接口调试进行调试。
003统一登录对接：云商店提供统一的登录门户，商家需要对接统一账号登录，可参考联营账号统一登录接入进行开发。
004对接完成：商家接口调试通过后，参考SaaS类商品资产管理与安全测试，获取应用凭证与测试账号。
005统一登录测试：商家通过测试账号进行统一登录的验证，并且验证成功。
006对接验收：如商家所涉及接口、联营统一账号登录都调试成功，请联系云商店技术专家进行联合测试验收！
可参考SaaS类联营商品接入示例代码、常见问题等文档来辅助您做技术对接。
2024年4月27日后新入驻的商家或者上架新商品，统一按照联营SaaS类商品联营KIT与技术对接方案 V2.0规范进行接口开发和调测，SaaS 2.0接口协议提供更高的安全性、可靠性、易用性。
SaaS 1.0 接口对接要求
| 场景 | 售卖方式--一次性 | 售卖方式--包年、包月 | 售卖方式--按需、按需套餐包 |
|---|---|---|---|
| 新购 | √（新购-按次） | √（新购-按次） | √（新购-按需、按需套餐包） |
| 续费 | x | √ | x |
| 过期 | x | √ | x |
| 释放 | √ | √ | √ |
| 升级 | x | O | x |
| 状态变更 | x | x | √ |
| 查询实例 | x | x | √ |
| 企业同步 | √ | √ | √ |
| 应用同步 | √ | √ | √ |
| 用户授权同步 | √ | √ | √ |
| 部门增量同步 | √ | √ | √ |
| 部门全量同步 | √ | √ | √ |
- 同一个商品发布时，针对不同的调用场景，只需要配置一个“生产系统接口地址”。
例如：https://www.isvwebsite.com/saasproduce
SaaS 1.0 接口执行规则
商家完成上架SaaS商品后，为监控接口服务的可用性和保障客户下单交易，云商店平台每天上午和下午，会对该商品接口地址的调测用例进行自动化拨测。当前接口拨测失败时，系统会邮件通知到商家云商店账号绑定的邮箱、短信、站内信，请商家及时修复接口，具体拨测规则如下：
| 商品状态 | 拨测规则 |
| 在售 | 执行 |
| 停售 | 不执行 |
| 退市 | 不执行 |
当商品的接口连续5天拨测失败，云商店运营经理会对该商品进行冻结交易并隐藏商品处理。根据《云商店商家合作管理规范》，如未及时修复接口，云商店运营有权对该商品进行下架处理。
接口失败场景及重试机制
- 针对新购场景接口调用失败的情况，云商店会持续调用3小时后停止调用，每次失败发送通知。期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试，若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。
- 针对续费场景接口调用失败的情况，云商店会持续调用1小时后停止调用，“卖家中心>生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。
- 针对过期（冻结、解冻、释放）场景接口调用失败的情况，云商店会持续调用1小时后停止调用，“卖家中心>生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。
- 针对升级场景接口调用失败的情况，云商店会持续调用3小时后停止调用，期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试。若商家接口问题在3小时调用时间内解决，则在下一次调用接口响应成功，订单开通成功；若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。
- 针对账号同步接口调用失败：云商店会持续调用5次后停止调用，每次失败发送通知，期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试。
- SaaS接口响应失败将通过邮件、短信、站内信进行通知，请注意关注账号绑定的邮箱、手机短信及站内信的相关通知。
- 若商品单月因接口失败导致的失败订单超过5个或者连续5天接口拨测失败，云商店将对该商品下架处理。
- 因接口响应失败导致自动退订的订单，请商家及时联系用户进行沟通，避免造成用户投诉，如因接口响应失败，导致用户过期后仍能正常使用所造成的资源损失，由商家自行承担。
