文档首页 > > 接入指南> SaaS类商品接入指南> 接口描述> 商品续费

商品续费

分享
更新时间:2020/09/30 GMT+08:00

接口说明

按周期售卖的商品,服务商必须实现续费接口生产开发。

  • 客户续费下单或试用商品转正后,云市场将调用该接口请求服务商执行业务延期,服务商接口需要执行将到期日进行更新,并返回通知云市场。
  • 服务商需要保障续费接口通畅,将业务进行延期,如续费失败,将可能导致用户的业务被释放的风险。
  • 针对续费场景接口调用失败的情况,云市场会调用1次,“卖家中心—生产接口消息”中可查询接口“异常信息”,请在修复接口异常后,通知云市场对该失败调用进行重新调用。
    • 请及时关注服务商信息中客服邮箱以及云市场账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。
    • 云市场会对接口异常的情况做监控,如SaaS商品频繁出现因接口异常的情况,云市场将对该商品做下架处理。

商品续费流程如下图所示:

请求消息

请求参数说明请参见下表:

参数

是否必选

类型

取值范围

说明

activity

M

String

20

接口请求标识,用于区分接口请求场景。

续费场景取值:refreshInstance

orderId

M

String

64

云市场订单ID。

instanceId

M

String

64

实例ID。

productId

O

String

64

产品标识,租户续费或转正产品实例时,如果订购周期类型发生变化,会传入变化后的产品类型对应的productId。

expireTime

M

String

20

过期时间。

格式:yyyyMMddHHmmss

testFlag

O

String

2

是否为调试请求。

  • 1:调试请求
  • 0:非调试请求

默认取值为“0”。

trialToFormal

O

String

2

是否是试用转正请求

  • 不传参数:不是
  • 1:是

默认不是试用转正。

默认不是试用转按需。

authToken

M

String

50

安全校验令牌。

取值请参见authToken取值说明

timeStamp

M

String

20

请求发起时的时间戳,取UTC时间。

格式:yyyyMMddHHmmssSSS

periodType

O

String

2

周期类型。

说明:

非必传,如需此参数,计费类型需选择包周期chargingMode=1,包周期购买场景请求时传该参数。

年:"year"

月:"month"

periodNumber

O

integer

2

周期数量。

说明:

非必传,如需此参数,计费类型需选择包周期chargingMode=1,包周期购买场景请求时传该参数。

周期数量:1,2,3…

orderAmount

O

bigdecimal

  

订单金额。

说明:

该金额为用户实际支付金额,供服务商对账参考。

金额值大于等于0,最大三位小数。

单位:元

2018年5月12日新增接口参数:productId和trialToFormal。

  • 2018年5月12日之后发布产品或已发布成功的产品新增规格时,请填写此新参数并通过接口调试(productId为空或者填值,trialToFormal“不传参数”或为“1”都要求调试通过)。
  • 2018年5月12日之前已发布成功的产品,如果不涉及免费试用变更,不要求做接口调试。

请求消息示例:

https://isvserver.com/produceAPI?activity=refreshInstance& expireTime=20180725000000&instanceId=03pf80c2bae96vc49b80b917bea776d7&orderId=HWS001014ED483AA1E8&timeStamp=20170725025113409&testFlag=0&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

响应消息

响应参数说明请参见下表:

参数

是否必选

类型

取值范围

说明

resultCode

M

String

6

调用结果码。

具体请参见调用结果码说明

resultMsg

O

String

255

调用结果描述。

  • 服务商的服务器在处理接口请求时,需要做好幂等性处理。
  • 云市场服务有可能重发请求,针对同一订单号,服务商的服务器应当返回成功的响应,不应该再做实例延期处理,返回成功响应即可。

响应消息示例:

{
    "resultCode":"000000",
    "resultMsg":"success."
}
分享:

    相关文档

    相关产品

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问