产品简介
Gate Pay 订阅支付为您提供基于区块链的 稳定币自动扣款能力 ,支持在 EVM 兼容链上按周期自动向您的用户收取 USDT 或 USDC,适用于 SaaS 订阅、会员服务、定期捐赠等场景。
核心优势:
- 用户一次授权,系统自动周期扣款,无需用户重复操作
- 支持试用期、首期特价灵活配置,降低用户转化门槛
- 扣款失败自动重试,减少订单流失
- 支持 Ethereum、Arbitrum、Polygon、BSC 四条主流 EVM 网络
接入流程
API文档:https://docs.gate.com/api-reference/version/100/cn/endpoint/subscription/productCreate
第一步:创建产品信息
通过 API 创建您的产品,需提供产品名称、描述、图片等信息

第二步:创建价格方案
在产品下创建价格方案,可配置以下参数:
| 参数 | 说明 |
|---|---|
| 扣款金额 | 单次扣款金额,最低 0.01 |
| 扣款币种 | USDT 或 USDC |
| 扣款周期 | 每天 / 每周 / 每月 / 每年,支持自定义间隔天数 |
| 首期特价(可选) | 支持固定金额或折扣比例,仅首次扣款生效 |
| 免费试用期(可选) | 设置试用天数,试用期内不扣款 |

第三步:创建订阅计划
将产品与价格方案关联,并设置用户授权扣款额度上限,生成订阅计划。

第四步:生成订阅链接并分发
调用 API 为用户创建订阅订单,获取 订阅支付链接 。
⚠️ 订阅链接有效期为 24 小时 ,请在有效期内将链接发送给用户。超时后需重新调用接口生成。
将链接发送给您的用户,用户点击后可自助完成钱包连接、额度授权及首次支付。
第五步:接收扣款通知
配置回调 URL 后,系统将在以下事件发生时主动通知您:
- 用户完成授权
- 首次扣款成功
- 每次周期扣款成功或失败
关键规则说明
扣款时间
系统每日统一在 北京时间 09:00(UTC 01:00) 批量处理周期扣款。
首次扣款触发规则
- 无试用期 :用户完成授权后, 立即 触发首次扣款
- 有试用期 :用户完成授权后进入试用期,试用期结束后自动触发首次扣款
- 配置了首期特价 :首次扣款按特价金额计算,后续按正常价格扣款
扣款失败处理
若因用户余额不足或授权额度不足导致扣款失败:
- 系统每隔 6 小时 自动重试,最多重试 2 次
- 重试全部失败后,订阅订单自动 关闭
- 关闭后如需恢复,需重新为用户生成订阅链接
订单状态说明
| 状态 | 含义 |
|---|---|
| 待授权 | 订单已创建,等待用户授权 |
| 已授权 | 用户已授权,等待首次扣款 |
| 试用中 | 用户在试用期内,暂未扣款 |
| 确认中 | 无试用期时,首次扣款处理中 |
| 进行中 | 周期性自动扣款正常执行中 |
| 已完成 | 达到设定总次数或结束日期,订阅正常结束 |
| 已取消 | 商户主动取消该订阅 |
| 未付款 | 扣款失败,等待系统自动重试 |
| 已关闭 | 重试次数达到上限,订阅关闭 |
| 拦截 | 链上交易成功,但 KYT 风控校验未通过 |
订单查询与管理
您可以通过以下两种方式查询扣款记录:
商户后台: 登录商户后台 → 收款订单 → 筛选订单类型「订阅支付」
API: 可通过 查询订阅订单详情(/open/v1/order/detail) 接口查询。
https://docs.gate.com/api-reference/version/100/cn/endpoint/subscription/orderDetail



注意事项
- 本期暂不支持修改已创建的订阅计划(金额、周期等),如需调整请重新创建新的订阅计划
- 手续费方案与现有 Gate Pay Web3 支付保持一致,订阅支付专项费率将在后续版本推出
- 用户授权时需自行承担 Gas 费;每次自动扣款的 Gas 费由平台承担
免责声明
本文内容仅供参考与学习目的,不构成任何金融、投资、交易或法律建议,也不构成购买或出售任何数字资产的要约或邀请。Gate 对文中信息的准确性、完整性或时效性不作任何明示或暗示的保证。产品功能、界面、规则及费率等信息可能随时更新或调整,请以 Gate 平台的最新公告及实际页面展示为准。
数字资产投资涉及高风险,价格可能出现大幅波动,您可能损失全部投入资金。请在充分了解相关风险的基础上,根据自身财务状况和风险承受能力谨慎决策。如有需要,建议您咨询独立的专业财务或法律顾问。
有关更多风险信息,请参阅 Gate 《风险警示》及 《用户协议》。
