周期代扣接入指南
产品介绍
周期代扣是基于小程序商家与用户事先的约定,在固定周期发起扣款的一种交易形式。常见于会员连续包月、自动充值等场景。详见周期代扣运营规范。
- •可用宿主端:抖音、抖音极速版
- •支持系统:Android
示例展示
支持独立签约后扣款、支付并签约两种应用场景。
接入流程
能力申请
申请范围:目前支持工具、内容消费(小说、短剧、长视频)、通信行业申请,其中短剧类小程序定向邀约,如需申请可联系行业运营或对接直客。
申请入口:支付产品管理-周期代扣。
审批时效:平台审批将在 5 个工作日内完成
申请基本条件:小程序上线、已开通担保支付企业版并完成进件、商户号主体注册资金 ≥ 100w、商户号主体注册时间 ≥ 3年。
未开通担保支付企业版请参考 FAQ 问题 3、4 进行操作。
基础条件 | 工具 | 小说 | 长视频 | 通信 | 短剧 |
备案 | 小程序需完成 ICP 备案 | ||||
接入通用交易系统 | |||||
首次上架时间 | 小程序上架时间 ≥ 30天 | ||||
万投率 | 小程序无过高投诉率 | ||||
处置记录 | 小程序无严重违规处置记录 | ||||
侵权记录 | 小程序无侵权成立记录,且无内容风险问题 | ||||
担保支付企业版 | 需开通担保支付企业版 | ||||
|
| ||||
支付订单金额和活跃用户数 | 以下条件满足其一即可
| 以下条件满足其一即可
| 以下条件满足其一即可
| 以下条件满足其一即可
| 以下条件满足其一即可
|
广告消耗 | —— | 近 30 天广告日均消耗 ≥ 10,000元 | —— | —— | 近 30 天广告日均消耗 ≥ 40,000元 |
说明
新规则将于 2025 年 8 月 18 日生效。
配置签约模板
平台审核通过后配置为签约模板,配置成功后平台分配模板ID,后续签约需要使用模板 ID。
模板唯一性,不同小程序下的模板 ID不可混用。
申请材料:提供以下信息,用于后续与用户签约使用。
价格说明:优惠金额与每期扣款金额价格差不能超过 3 倍(首期优惠不能低于代扣金额的三分之一)。
说明
目前仅支持逐一添加,暂不支持批量操作。
类型 | 配置项目 | 填写说明 | 举例 | 展示位置 |
基础信息 | 小程序基本信息 | 小程序名 + appid | —— | |
小程序商户号 | 小程序商户号 | —— | | |
代扣模板页面展示内容 | 产品模板名称 | 商户自定义,小于 15 个字,明确透出【连续】、【周期】等相关字样。 注意 模板名称不可包含抖音、抖音小程序、字节小程序、金额、营销词、极限词如最、超级等词汇。 | 小说 VIP 会员包月自动续费 京趣会员包月自动续费 | |
签约商户简称 | 商户自定义,小于 10 个字。 | 可与小程序名称保持一致,或可明确识别与小程序关系。 | ||
产品模板详情描述 | 商户自定义,小于 100 个字,体现出可随时取消不再自动扣款说明。 注意 如有优惠价格,需明确展现具体优惠金额和权益周期,如新用户专享 10元/3天,到期前自动续费 15元/月,可随时取消。不可使用概括优惠词语未明确金额,如新用户可享受签约优惠。 |
| ||
商户icon | 商户自定义,高清图片,支持 BMP、JPG、JPEG、PNG 格式,大小不超过 2MB。 | —— | ||
扣款规则 | 扣款周期 | 自然月 | —— | |
每期扣款金额 |
| 包月续费按照 22 元扣费 | | |
前N期是否有优惠 |
| —— | | |
扣款渠道 | 抖音支付和支付宝支付,支持多选 | | | |
其他 | 解约回调地址 | 用户操作解约后,会通过该地址告知解约结果 | | |
客服电话 | 用户产生疑问时的咨询电话 | | |
系统开发
根据接口清单,完成签约接口、扣款接口、退款接口的开发对接
接口清单
接口名称 | 接口类型 | 功能简述 | 文档链接 |
下签约订单 | JS API | 可调用该接口,生成一笔签约单。 | |
获取签约页面 | JS API | 下签约订单后,通过该接口唤起周期代扣的签约页面,引导用户签约或签约并支付。 | |
发起解约 | OpenAPI | 签约成功后,商户可包装该接口,在小程序页面内向用户提供解约能力。 | |
签约订单查询 | OpenAPI | 查询签约订单状态。 | |
签约结果通知 | OpenAPI | 签约成功、超时或解约后,通知开发者签约状态。 | |
发起代扣 | OpenAPI | 签约成功后,可通过该接口创建代扣单,向用户发起代扣。 | |
代扣结果查询 | OpenAPI | 查询代扣单状态。 | |
代扣结果通知 | OpenAPI | 扣款成功或超时后,通知开发者代扣结果。 | |
发起退款 | OpenAPI | 代扣成功后,可通过该接口创建退款单,向用户发起退款。 | |
预扣费通知(必接能力) | OpenAPI | 用于在发起正式扣费前的用户通知,只有成功发起通知才受理本周期扣款请求。
| |
退款查询 | OpenAPI | 查询退款单状态。 | |
退款结果通知 | OpenAPI | 退款成功或失败后,通知开发者退款结果。 | |
结算 | OpenAPI | 订单到达结算周期后,开发者可以通过分账接口将这笔订单产生的资金结算给各个分账方。 |
流程说明
纯签约
签约并支付
代扣
退款
订单状态机
签约单
代扣单
退款单
FAQ
如何查看经营指标?
经营指标 | 查询路径 | 示意图 |
支付订单金额 | 控制台-数据-数据中心-交易 | |
活跃用户数 | 控制台-数据-数据中心-用户 | |
广告消耗 | 巨量广告-账户后台-竞价推广-通投广告 |
模板内容可以修改吗?
模板不支持修改扣款周期,扣款金额不可超过申请周期代扣模板的上限。icon、商户简称等可正常修改。
支持指定商户号下单的小程序申请周期代扣能力吗?
不支持申请的小程序使用其他小程序商户号下单
如何判断开通了担保支付企业版还是普通版?
支付能力中查看开通的类型
未开通担保支付企业版如何解决?
联系平台客服开通担保支付企业版后接入能力
在哪里修改模板/怎么修改模板?
当前不支持已使用并通过的模板进行修改,如开发者需要调整原模板内容,请重新创建,并及时对新增签约订单变更小程序调用的模板ID。
怎么从普通版迁移到企业版?
迁移流程如下:
操作步骤 | 图例展示 | 操作指引 |
第一步:点击确认迁移 | |
|
第二 步:商户根据页面指引完成企业版开通 | 特殊说明:如果迁移前同一个商户号三个进件主体不一致,迁移后要求保持一致,且提交《关联关系证明函》,规则详见“同一个商户号三个进件主体不一致如何处理?” | 开发者需要在该页面操作企业版开通,并完成进件。可以根据页面提示,重点检查【企业版开通状态】字段都为“已开通”或“暂不开通”:
|
第三步:发起交易迁移 | 确认【企业版开通状态】字段都为“已开通”或“暂不开通”,点击下方“确认迁移”。
确认迁移后,平台即刻对小程序进行迁移,预计1-3个工作日完成迁移。迁移期间,进件可能会有延迟,如有问题,联系抖音开放平台客服。迁移成功后,交易会自动切换至担保支付企业版,平台会以站内信的形式通知开发者迁移结果。 | |
第四步:迁移结果查询 | “支付能力”页面依旧显示“支付解决方案迁移中”,且显示担保支付解决方案,即“未完成迁移”,可根据页面提示等待处理。 | |
“支付能力”页面无“待迁移”/“迁移中”提示,且显示担保支付企业版解决方案,即为“完成迁移” |
平台已有的续费管理入口有哪些?
路径 | 样式图 | 说明 |
抖音 App 侧边栏展开->【常用小程序-全部】-> 右上角【订单】->【续费管理】 |
| |
抖音 App 小程序内->【反馈】->【续费管理】 |
| |
抖音主端侧边栏【我的钱包】->抖音支付->设 置->自动付款 | |
|
支付宝 App >我的->设置->支付设置->免密支付/自动扣款 |
|