SPI主动通知交付简介

如果采用主动通知的生产方式，您需要按照云市场提供的SPI接口规范进行SPI接口开发（商品发布过程中需要填写接口的生产地址）。在用户购买、续费、升级等动作完成时或订购到期、释放时，云市场通过调用您提供的生产地址，通知您实施购买、续费、升级、过期、释放等动作，动作完成后返回给云市场相关信息。

成为云市场服务商后，请遵循以下流程，完成 SaaS类商品接入：

注意：步骤 1 & 步骤 2 生产接口的开发和调试需要由您公司的技术人员完成。

步骤 1：准备生产接口服务器，请根据接入文档开发生产接口。

步骤 2：点击服务商MSP后台-工具-应用接入调试，进行接口调试，请参考文档：应用软件（SaaS）类商品服务商自测

步骤 3：点击服务商MSP后台-商品管理 ，申请发布应用软件类

步骤 4：云市场运营人员审批通过后商品发布成功。

SPI主动通知业务流程

1. 新购流程

用户下单后，云市场通过服务商生产地址创建实例，根据接口返回值在买家控制台展示实例信息，包括应用信息、主机&备案信息、备注等内容。

应用信息

用户通过服务商创建实例接口返回的应用信息使用SaaS产品，主要有两种常见的方式，可以任选其一或两者皆有：

• 返回应用的前台/管理地址、管理员账号&密码，用户在买家控制台已购买服务详情中通过链接跳转后输入账号密码访问。

• 返回免登地址，用户在买家控制台已购买服务详情中直接跳转访问，免登可参考应用免登。

备注

用户在买家控制台已购买服务详情中可以查看通过创建实例返回备注信息，对产品使用的关键点进行说明。

主机&备案信息

主机&备案信息包括主机IP和域名等。

2. 过期流程

对于周期类包年包月商品，当用户购买的实例到期但未续费时调用生产地址过期实例，服务商收到过期实例调用后，需冻结产品功能，但还不能删除用户实例，后续用户续费后为用户恢复产品功能。

对于按量计费商品，当用户未及时支付账单导致按量计费商品实例欠费一段时间后，也会调用生产地址过期实例，服务商收到过期实例调用后，需冻结产品功能，但还不能删除用户实例，后续用户支付欠费后为用户恢复产品功能。

3. 续费流程

对于周期类包年包月商品，当用户对包年包月商品进行续费时会调用生产地址续费实例，服务商收到续费实例调用后，根据续费时长延长产品的使用时间。

对于欠费过期的按量计费商品，当用户支付按量计费商品实例的欠费账单时，也会调用生产地址续费实例，服务商收到续费调用后，需为用户恢复产品功能。

4. 升级流程

当用户从商品的原购买规格升级到更高规格时调用生产地址升级实例，服务商收到升级实例调用后，需要根据升级后的规格为用户开通相应的产品功能。

5. 释放流程

当用户购买的实例到期一段时间后且一直未续费，或按量计费商品实例欠费一段时间后，会调用生产地址释放实例，服务商收到过期实例调用后，可以删除相应的用户实例和数据。

6. 生产通知重试

生产通知如果调用服务商接口失败会触发重试机制，最多重试120次。服务商可以在生产消息重试页面查看生产通知异常，对于重试达到120次仍未成功的，可以操作重置生产次数，重新开始重试。

SPI主动通知接入流程

1. 如需采用SPI主动通知交付，需按照云市场提供的SPI接口规范进行SPI接口开发，参考SPI指南。

2. SPI接口开发完成后发布到公网，确保接口地址公网可访问。

3. 在商品发布时，应用开通方式选择“生产接口主动通知”，填写生产系统接口地址（不包含参数部分），参考通过SPI接口方式接入。

4. 商品发布后提交审核，商品进入预上架状态，服务商需对下单生产流程进行自测，并按照要求填写测试报告，将测试报告发邮件给运营，由运营进行审核，参考应用软件（SaaS）类商品服务商自测。

SPI主动通知接口

SPI指南

接口调试工具

在发布商品前，服务商可以使用接口调试工具测试接口参数token校验以及参数值获取是否正确。