接口功能及说明

商家发布SaaS商品时，首先需根据本接入指南，在生产接口服务器开发一个生产系统接口。

同一个商品发布时，针对不同的调用场景（新购、续费、过期、释放和升级），只需要配置一个“生产系统接口地址”。

如果发布包周期商品，接口需实现“新购”、“续费”、“过期”、“释放”四种场景的调用。如果发布按次商品，接口需实现“新购商品”和“释放”场景的调用。

“升级”场景，不做强制要求，由商家自行确定，如所发布的商品有升级场景，则需实现；如无，则忽略。

• 客户续费下单或试用商品转正付款成功后，云商店将调用该接口（续费场景）请求商家执行业务延期，商家接口需要执行将到期日进行更新，并将执行结果返回给云商店。
• 客户购买的商品过期时，云商店调用该接口（过期场景），商家接到该通知以后应该将指定的实例冻结，并将执行结果返回给云商店。
  

  用户订单到期后，根据客户等级的不同，有最长15天的资源冻结期，冻结期内资源不可使用，但可以对此订单续费以解冻继续使用，所以商家需对SaaS商品设置15天的冻结期，并在冻结期内保留用户数据。

• 当客户已购买的商品到期不续订且超过冻结期、或申请退订商品成功时，云商店将释放客户购买的商品并调用该接口（资源释放场景），商家接收到该通知以后删除指定的实例，并将执行结果返回给云商店。
• 客户对已购买的商品升级下单且付款成功后，云商店将调用该接口（升级场景）请求商家执行升配，商家接口需要执行将商品进行升配，并将执行结果返回给云商店。升级场景为非必选场景，商家可自行确定是否需要。

接口失败场景及重试机制

当接口响应失败时，系统会邮件通知到商家云商店账号绑定的邮箱，“卖家中心>生产接口消息”中可查询接口“异常信息”，商家收到通知后须尽快处理接口异常，避免订单失败退订。

• 针对新购场景接口调用失败的情况：
  1. 当涉及服务监管，云商店会持续调用3小时（每小时1次）后停止调用，每次失败发送通知。期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试，若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。
  2. 如不涉及服务监管，云商店会持续调用3小时（每3分钟1次）后停止调用，每失败5次发送通知。期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试，若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。
• 针对续费场景接口调用失败的情况，云商店会调用1次，“卖家中心>生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。
• 针对过期（冻结、解冻、释放）场景接口调用失败的情况，云商店会调用1次，“卖家中心>生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。
• 针对升级场景接口调用失败的情况，云商店会持续调用3小时（每小时1次）后停止调用，期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试。若商家接口问题在3小时调用时间内解决，则在下一次调用接口响应成功，订单开通成功；若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。

如因接口响应失败，导致用户过期后仍能正常使用所造成的资源损失，由商家自行承担。

• SaaS接口响应失败将通过邮件、短信、站内信进行通知，请注意关注账号绑定的邮箱、手机短信及站内信的相关通知。
• 若商品单月因接口失败导致的失败订单超过5个或长时间拨测失败，云商店将对该商品下架处理。
• 因接口响应失败导致自动退订的订单，请商家及时联系用户进行沟通，避免造成用户投诉。