云市场云市场

更新时间:2021/07/08 GMT+08:00
分享

接口功能及说明

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

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

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

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

接口功能

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

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

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

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

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

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

接口失败场景及重试机制

当接口响应失败时,系统会邮件通知到服务商云市场账号绑定的邮箱,“卖家中心>生产接口消息”中可查询接口“异常信息”,服务商收到通知后须尽快处理接口异常,避免订单失败退订。
  • 针对新购场景接口调用失败的情况,云市场会持续调用3小时(每小时1次)后停止调用,期间服务商可在“卖家中心>生产接口消息”页面单击对应接口右侧操作栏的“重新启动”进行手动重试。若服务商接口问题在3小时调用时间内解决,则在下一次调用接口响应成功,订单开通成功;若服务商接口问题在3小时调用后仍未解决,系统则判断订单为失败,并自动进行订单退订。
  • 针对续费场景接口调用失败的情况,云市场会调用1次,“卖家中心>生产接口消息”中可查询接口“异常信息”,请在修复接口异常后,通知云市场partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”,单击右侧操作栏的“重新启动”进行手动重试。
  • 针对过期(冻结、解冻、释放)场景接口调用失败的情况,云市场会调用1次,“卖家中心>生产接口消息”中可查询接口“异常信息”,请在修复接口异常后,通知云市场partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”,单击右侧操作栏的“重新启动”进行手动重试。
  • 针对升级场景接口调用失败的情况,云市场会持续调用3小时(每小时1次)后停止调用,期间服务商可在“卖家中心>生产接口消息”页面单击对应接口右侧操作栏的“重新启动”进行手动重试。若服务商接口问题在3小时调用时间内解决,则在下一次调用接口响应成功,订单开通成功;若服务商接口问题在3小时调用后仍未解决,系统则判断订单为失败,并自动进行订单退订。
如因接口响应失败,导致用户过期后仍能正常使用所造成的资源损失,由服务商自行承担。
  • SaaS接口响应失败将通过邮件、短信、站内信进行通知,请注意关注账号绑定的邮箱、手机短信站内信的相关通知。
  • 若商品单月因接口失败导致的失败订单超过5个,云市场将对该商品下架处理。
  • 因接口响应失败导致自动退订的订单,请服务商及时联系用户进行沟通,避免造成用户投诉。
分享:

    相关文档

    相关产品