接口说明

###一、SaaS商品接入前提

服务商发布SaaS商品时，需要按照云市场提供的生产接口规范进行生产接口开发（商品发布过程中需要填写接口的生产地址）。在用户购买、续费、退订等动作完成之后，云市场通过调用服务商提供的生产地址，通知服务商实施购买、续费、关停等动作，动作完成后返回给云市场相关信息。

说明：
1.同一个商品发布时，针对不同的调用场景（新购、续费、过期、回收和升级），只需要配置一个“生产系统接口地址”。
2.生产接口开完完成后可以使用在线调试工具进行调试，调试通过后方可发布SaaS商品。

二、接口说明

1.新购资源

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

说明：
1.新购资源时，服务商在处理接口时，需要做好幂等性处理，可用订单ID作为幂等标识。针对同一订单号，应当返回成功的响应及实例信息，不应该创建新的SaaS实例，返回之前成功创建的实例信息即可。
2.请不要阻塞此接口，如果耗时较长（处理时长超过10秒），建议使用队列做缓冲处理，设置instanceId=0，然后立即返回。若操作失败也请设置instanceId=0，云市场会再次调用，直到获取到instanceId。若资源开通失败，平台会自动退款给客户。
3.若商品单月因接口失败导致的失败订单超过5个，云市场将对该商品下架处理。

2.续费资源

客户续费下单或试用商品转正付款成功后，云市场将调用该接口（续费场景）请求服务商执行业务延期，服务商接口需要执行将到期日进行更新，并将执行结果返回给云市场。

3.升级资源

客户对已购买的商品升级下单且付款成功后，云市场将调用该接口（升级场景）请求服务商执行升配，服务商接口需要执行将商品进行升配，并将执行结果返回给云市场。

4.冻结资源

客户购买的商品过期时，云市场调用该接口（过期场景），服务商接到该通知以后应该将指定的实例冻结，并将执行结果返回给云市场。

包年包月的实例有保留期，实例到期后，保留7 天，云市场会在实例到期（2019-10-01 23:59:59）后第7天零点（2019-10-08 00:00:00）发送回收资源消息。

5.回收资源

当客户已购买的商品到期不续订且超过冻结期、或申请退订商品成功时，云市场将释放客户购买的商品并调用该接口（回收场景），服务商接收到该通知以后删除指定的实例，并将执行结果返回给云市场。