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

Gate Pay Web3 訂閱支付指引 | Gate

2026-06-23 (UTC+8)
4 閱讀
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