接口功能及说明

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

• 同一个商品发布时，针对不同的调用场景（新购、续费、过期、释放和升级），只需要配置一个“生产系统接口地址”。
• 如果发布包周期商品，接口需要实现“新购商品”、“续费”、“过期”、“释放”四种场景的调用。
• 如果发布按次商品，接口需实现“新购商品”和“释放”场景的调用。
• 如果发布按需商品，接口需实现“新购商品”“资源状态变更”“释放”“按需使用量推送”
• “升级”场景，不做强制要求，由服务商自行确定，如所发布的商品有升级场景，则需实现；如无，则忽略。

• 客户购买商品并付款成功，云商店将调用本接口（新购场景）通知服务商客户购买商品的信息和客户信息，商品生产环境收到该请求信息，需执行新购对应动作并将执行结果返回给云商店。
  

  用户购买商品后，在“买家中心”点击该商品的“资源详情”查询使用信息时，会实时调用接口（新购场景）进行查询，故服务商的服务器在处理接口请求时，需要做好幂等性处理。即云商店服务有可能重发请求，针对同一订单号，服务商的服务器应当返回成功的响应及应用实例信息，不应该创建新的SaaS实例，返回之前成功创建的实例信息即可。

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

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

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