周期代扣接入指南
收藏一、产品介绍
周期代扣是基于小程序商家与用户事先的约定，在固定周期发起扣款的一种交易形式。常见于会员连续包月、自动充值等场景。详见周期代扣运营规范。
- •可用宿主端：抖音、抖音极速版
- •支持系统：Android
二、示例展示
支持独立签约后扣款、支付并签约两种应用场景。
三、接入流程
3.1能力申请
（1）申请范围：目前支持小说、短剧、长视频、通信行业申请
行业 | 主营类目 |
小说 | 文娱-文娱-在线阅读 |
短剧 | 文娱-文娱-微短剧 |
长视频 | 文娱-文娱-长视频 |
通信行业 | IT 科技-IT 科技-电信业务代理商 IT 科技-IT 科技-基础电信运营商 IT 科技-IT 科技-增值业务运营商及代理商 IT 科技-IT 科技-虚拟运营商及代理商 |
（2）申请入口：支付产品管理-周期代扣。
审批时效：平台审批将在 5 -10个工作日内完成
基础规则 | ||||
| ||||
行业特殊条件 | 小说 | 长视频 | 通信 | 短剧 |
首次上架时间 | 小程序上架时间>=30天 | 小程序上架时间>=30天 | 小程序上架时间>=30天 | 小程序上架时间>=30天 |
万投率 | 近30天万投率<0.5 | 近30天万投率<0.33 | 近30天万投率<1.5 | 近30天万投率<0.1 |
无违规记录 | 历史无小程序处置下架、小程序封禁、主体封禁、支付拦截 | —— | 历史无小程序处置下架、小程序封禁、主体封禁、支付拦截 | 历史无小程序处置下架、小程序封禁、主体封禁、支付拦截 |
支付订单金额和活跃用户数 | 以下条件满足其一即可 （1）近30天累计支付订单金额>=90000元且近30天活跃用户数>=3000 （2）近30天活跃用户数>=40000 | 以下条件满足其一即可 （1）近30天累计支付订单金额>=2000元且近30天活跃用户数>=1000 （2）近30天活跃用户数>=10000 | 以下条件满足其一即可 （1）近30天累计支付订单金额>=10000元且近30天活跃用户数>=2000 （2）近30天活跃用户数>=50000 | 以下条件满足其一即可 （1）近30天累计支付订单金额>=500000元且近30天活跃用户数>=20000 （2）近30天活跃用户数>=600000 |
广告消耗 | 近30天广告日均消耗>=10000元 | —— | —— | 近30天广告日均消耗>=40000元 |
3.2配置签约模板
平台审核通过后配置为签约模板，配置成功后平台分配模板ID，后续签约需要使用模板ID，
模板唯一性，不同小程序下的模板ID不可混用。
申请材料：提供以下信息，用于后续与用户签约使用。
价格说明：优惠金额与每期扣款金额价格差不能超过3倍（首期优惠不能低于代扣金额的三分之一）且不可低于1元。
优惠周期：【月】周期支持优惠7天以上，【周】周支持优惠5天
支持：XXX小程序会员新用户享受签约前7天10元，到期自动续费30元/月；XXX小程序会员新用户享受签约前5天6，到期自动续费18元/周。不支持：XXX小程序会员新用户享受签约前3天1元，到期自动续费30元/月；XXX小程序会员新用户享受签约前3天6，到期自动续费18元/周；XXX小程序会员新用户享受签约免费试用3天，到期自动续费18元/周。
扣款周期：长视频、通信支持申请“月”扣款周期模板，短剧和小说行业支持申请“月”、“周”扣款周期模板
说明
目前仅支持逐一添加，暂不支持批量操作。
配置内容 | 填写说明 | 举例 | 展示位置 |
模板类型 | 会员、自动充值二选一 | —— | —— |
模板名称 | 商户自定义，小于15个字，明确透出【连续】、【周期】等相关字样。 注意：模板名称不可包含抖音、抖音小程序、字节小程序、金额、营销词、极限词如最、超级等词汇 | 小说VIP会员包月自动续费 京趣会员包月自动续费 | |
模板详情 | 商户自定义，小于100个字，体现出可随时取消不再自动扣款说明。 注意：如有优惠价格，需明确展现具体优惠金额和权益周期，如新用户专享10元/3天，到期前自动续费15元/月，可随时取消。不可使用概括优惠词语未明确金额，如新用户可享受签约优惠。 |
| |
商户图标 | 商户自定义，高清图片，支持BMP、JPG、JPEG、PNG 格式，大小不超过 2MB | —— | |
商户简称 | 商户自定义，小于10个字 | 可与小程序名称保持一致，或可明确识别与小程序关系 | |
扣款周期 | 月（扣款周期30天）
| —— | —— |
每期扣款金额 |
| 包月续费按照22元扣费 | —— |
前N期是否有优惠金额 |
| —— | —— |
扣款渠道 | 抖音支付和支付宝支付，支持多选 | —— | —— |
解约回调地址 | 用户操作解约后，会通过该地址告知解约结果 | —— | —— |
客服电话 | 用户产生疑问时的咨询电话 | —— | —— |
客服电话 | 用户产生疑问时的咨询电话 | | |
3.3系统开发
根据接口清单，完成签约接口、扣款接口、退款接口的开发对接
3.3.1流程说明
流程类型 | 流程图示 |
纯签约 | |
签约并支付 | |
代扣 | |
退款 |
3.3.2订单状态机
订单状态 | 流程 |
签约单 | |
代扣单 | |
退款单 |
3.3.3 接口清单
接口名称 | 接口类型 | 功能简述 | 文档链接 |
下签 约订单 | JS API | 可调用该接口，生成一笔签约单。 | |
获取签约页面 | JS API | 下签约订单后，通过该接口唤起周期代扣的签约页面，引导用户签约或签约并支付。 | |
发起解约 | OpenAPI | 签约成功后，商户可 包装该接口，在小程序页面内向用户提供解约能力。 | |
签约订单查询 | OpenAPI | 查询签约订单状态。 | |
签约结果通知 | OpenAPI | 签约成功、超时或解约后，通知开发者签约状态。 | |
发起代扣 | OpenAPI | 签约成功后，可通过该接口创建代扣单，向用户发起代扣。 | |
代扣结果查询 | OpenAPI | 查询代扣单状态。 | |
代扣结果通知 | OpenAPI | 扣款成功或超时后，通知开发者代扣结果。 | |
发起退款 | OpenAPI | 代扣成功后，可通过该接口创建退款单，向用户发起退款。 | |
预扣费通知（必接能力） | OpenAPI | 用于在发起正式扣费前的用户通知，只有成功发起通知才受理本周期扣款请求。
| |
退款查询 | OpenAPI | 查询退款单状态。 | |
退款结果通知 | OpenAPI | 退款成功或失败后，通知开发者退款结果。 | |
结算 | OpenAPI | 订单到达结算周期后，开发者可以通过分账接口将这笔订单产生的资金结算给各个分账方。 |
