续费变配接入

本文介绍了续费变配接入的基本流程。

名词说明和注释

说明

以下名词解释均针对应用/内购商品的购买过程。

名词	说明	注释
新购	用户第一次购买或之前的购买行为到期后重新购买	用户没有当前要购买的商品的在用实例则购买行为视为新购。

注意

针对周期型商品付费规格之间从低规格到高规格的购买视为升级。
针对周期升级计量型商品规格版本从低到高或者使用人数从少到多均视为升级。

|
|续费升级|用户对当前使用的规格做延长使用期的操作，延长部分的规格版本是升级后的高版本|

续费升级是在当前在用规格到期前操作。

续费升级操作成功后当前规格继续使用直到到期结束，结束后续费的周期段会升级到高规格版本。

|
|续费降级|用户对当前使用的规格做延长使用期的操作，延长部分的规格版本是降级后的低版本|

续费升级是在当前在用规格到期前操作。

续费升级操作成功后当前规格继续使用直到到期结束，结束后续费的周期段会降级到低规格版本。

1. 续费变配功能说明

续费、升级、升级续费（续费升级）、降级续费(续费降级)的实现形式如下图所示。

2. 接入条件

添加订单、订购推送消息订阅

推送消息接入分为HTTP接入****和RDS接入，具体接入形式请在开发者后台进行配置，配置样例如下。

推送类型为使用HTTP推送时，不需要做额外的订阅。

推送类型为使用SyncHTTP推送或使用钉钉云推送时，需要勾选下图标识出来的2个订阅事件。

订单推送、订购推送消息开发对接

说明

钉钉开放平台消息推送分为HTTP模式和RDS模式。

HTTP模式是基于开发者后台配置的推送http地址将对应的推送信息通过post方式推送过去。

RDS模式是RDS实例接收钉钉消息时，在钉钉云环境下通过创建对应的数据库表结构，钉钉开放平台将推送的数据写入到指定的表。

订单消息推送

目前钉钉开放平台会在订单支付、订单关闭、订单退款的时候，将对应的订单消息进行推送，推送形式当前为http模式和rds模式，两种模式推送过去的数据是一致的。

推送的数据格式请参考数据格式biz_type=17。

订购消息推送

目前钉钉开放平台会在订购服务开通、订购服务到期的时候，将对应的订购消息进行推送，推送形式当前为http模式和rds模式，两种模式推送过去的数据是一致的。

推送的数据格式请参考数据格式biz_type=37。

3. 测试

你可以通过以下两种方式进行测试。

按照订单推送、订购推送数据结构自行mock下数据进行单测验证。

联系钉钉钉钉开发小二。

扫描以下二维码，加入续费变配ISV沟通群。
9090184b8e824f31bd1e2b74030edcb80521

联系群里面钉钉的开发负责同学将要申请接入续费变配的商品信息进行开放。

联系群里面钉钉的开发负责同学进行续费变配各场景的下单验证。

4. 验收

验证商品接入续费变配功能后能否进行续费升级和续费降级订单的创建、支付、订单信息推送。

验证续费升级、续费降级后新规格开始生效时，是否有收到钉钉平台推送的订购生效通知。

验证推送的订单消息、订购开通消息是否收到，字段信息是否齐全，数据是否符合预期。

上述三点都验证通过后可以联系“续费变配ISV沟通群”的钉钉开发同学对客开放申请商品的续费变配功能。

名词说明和注释#

1. 续费变配功能说明#

2. 接入条件#

3. 测试#

4. 验收#

名词说明和注释

1. 续费变配功能说明

2. 接入条件

3. 测试

4. 验收