帮助中心
Gate Pay
商家接入说明

Gate Pay Web3 订阅支付指引 | Gate

2026-06-23 (UTC+8)
3 阅读量
0

产品简介

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 创建您的产品,需提供产品名称、描述、图片等信息

1

第二步:创建价格方案

在产品下创建价格方案,可配置以下参数:

参数 说明
扣款金额 单次扣款金额,最低 0.01
扣款币种 USDT 或 USDC
扣款周期 每天 / 每周 / 每月 / 每年,支持自定义间隔天数
首期特价(可选) 支持固定金额或折扣比例,仅首次扣款生效
免费试用期(可选) 设置试用天数,试用期内不扣款
1
注:FIX_AMOUNT: 固定金额扣款:系统自动周期扣款,每期金额固定 ACCOUNT_AUTH: 授权支付:用户授权一定金额,商户在该金额内可任意扣款

第三步:创建订阅计划

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

1

第四步:生成订阅链接并分发

调用 API 为用户创建订阅订单,获取 订阅支付链接
⚠️ 订阅链接有效期为 24 小时 ,请在有效期内将链接发送给用户。超时后需重新调用接口生成。
将链接发送给您的用户,用户点击后可自助完成钱包连接、额度授权及首次支付。

第五步:接收扣款通知

配置回调 URL 后,系统将在以下事件发生时主动通知您:

  • 用户完成授权
  • 首次扣款成功
  • 每次周期扣款成功或失败

关键规则说明

扣款时间

系统每日统一在 北京时间 09:00(UTC 01:00) 批量处理周期扣款。

首次扣款触发规则

  • 无试用期 :用户完成授权后, 立即 触发首次扣款
  • 有试用期 :用户完成授权后进入试用期,试用期结束后自动触发首次扣款
  • 配置了首期特价 :首次扣款按特价金额计算,后续按正常价格扣款

扣款失败处理

若因用户余额不足或授权额度不足导致扣款失败:

  1. 系统每隔 6 小时 自动重试,最多重试 2 次
  2. 重试全部失败后,订阅订单自动 关闭
  3. 关闭后如需恢复,需重新为用户生成订阅链接

订单状态说明

状态 含义
待授权 订单已创建,等待用户授权
已授权 用户已授权,等待首次扣款
试用中 用户在试用期内,暂未扣款
确认中 无试用期时,首次扣款处理中
进行中 周期性自动扣款正常执行中
已完成 达到设定总次数或结束日期,订阅正常结束
已取消 商户主动取消该订阅
未付款 扣款失败,等待系统自动重试
已关闭 重试次数达到上限,订阅关闭
拦截 链上交易成功,但 KYT 风控校验未通过

订单查询与管理

您可以通过以下两种方式查询扣款记录:
商户后台: 登录商户后台 → 收款订单 → 筛选订单类型「订阅支付」
API: 可通过 查询订阅订单详情(/open/v1/order/detail) 接口查询。
https://docs.gate.com/api-reference/version/100/cn/endpoint/subscription/orderDetail

1 1
## 订阅界面展示
1 1
1

注意事项

  • 本期暂不支持修改已创建的订阅计划(金额、周期等),如需调整请重新创建新的订阅计划
  • 手续费方案与现有 Gate Pay Web3 支付保持一致,订阅支付专项费率将在后续版本推出
  • 用户授权时需自行承担 Gas 费;每次自动扣款的 Gas 费由平台承担

免责声明

本文内容仅供参考与学习目的,不构成任何金融、投资、交易或法律建议,也不构成购买或出售任何数字资产的要约或邀请。Gate 对文中信息的准确性、完整性或时效性不作任何明示或暗示的保证。产品功能、界面、规则及费率等信息可能随时更新或调整,请以 Gate 平台的最新公告及实际页面展示为准。

数字资产投资涉及高风险,价格可能出现大幅波动,您可能损失全部投入资金。请在充分了解相关风险的基础上,根据自身财务状况和风险承受能力谨慎决策。如有需要,建议您咨询独立的专业财务或法律顾问。
有关更多风险信息,请参阅 Gate 《风险警示》《用户协议》

立即注册,最高可领 $10,000 迎新奖励
signup-tips