文档首页 > > 接入指南> SaaS类商品接入指南> 接口说明

接口说明

分享
更新时间:2020/10/16 GMT+08:00

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

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

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

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

    买家购买成功后,使用信息查询操作及页面展示参考SaaS类商品使用指导

    针对新购场景接口调用失败的情况,云市场会持续调用到60次(每3分钟1次)后停止调用。若服务商接口问题在60次调用时间内解决,则在下一次调用时调用接口响应成功,订单开通成功;若服务商接口问题在60次调用后仍无解决,系统则判断订单为失败,并自动进行订单退订。

    若商品单月因接口失败导致的失败订单超过5个,云市场将对该商品下架处理。

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

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

  • 当客户已购买的商品到期不续订且超过冻结期、或申请退订商品成功时,云市场将释放客户购买的商品并调用该接口(释放场景),服务商接收到该通知以后删除指定的实例,并将执行结果返回给云市场。
  • 客户对已购买的商品升级下单且付款成功后,云市场将调用该接口(升级场景)请求服务商执行升配,服务商接口需要执行将商品进行升配,并将执行结果返回给云市场。
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问