製品概要
Gate Pay サブスクリプション決済は、ブロックチェーンベースのステーブルコイン自動引き落とし機能を提供し、EVM互換チェーン上で設定したスケジュールに従って、ユーザーからUSDTまたはUSDCを自動的に回収できます。このソリューションは、SaaSサブスクリプション、会員サービス、定期的な寄付などのシナリオに最適です。
主な利点:
- ユーザーによる一度の認可で、システムが自動的に定期引き落としを実行—繰り返しのユーザー操作は不要
- トライアル期間や初回特別価格の柔軟な設定により、ユーザーの利用開始ハードルを低減
- 引き落とし失敗時の自動リトライで注文損失を削減
- 主要なEVMネットワーク4種に対応：Ethereum、Arbitrum、Polygon、BSC
統合プロセス
APIドキュメント: https://docs.gate.com/api-reference/version/100/en/endpoint/subscription/productCreate
ステップ1：商品情報の作成
APIを通じて商品を作成し、商品名、説明、画像などの詳細情報を入力します。
ステップ2：料金プランの作成
商品ごとに料金プランを作成し、以下のパラメータを設定できます：
| パラメータ | 説明 |
|---|---|
| 引き落とし金額 | 1回あたりの金額、最小0.01 |
| 引き落とし通貨 | USDTまたはUSDC |
| 引き落とし周期 | 毎日／毎週／毎月／毎年、カスタム日数も設定可能 |
| 初回特別価格（任意） | 固定金額または割引率に対応、初回引き落とし時のみ適用 |
| 無料トライアル期間（任意） | トライアル日数を設定、期間中は引き落としなし |
注記:
FIX_AMOUNT：固定金額引き落とし—システムが毎回固定金額を自動で引き落とします
ACCOUNT_AUTH：認可払い—ユーザーが一定額を認可し、その範囲内で加盟店が任意の金額を引き落とせます
ステップ3：サブスクリプションプランの作成
商品と料金プランを紐付け、ユーザーが認可する最大引き落とし上限を設定し、サブスクリプションプランを生成します。
ステップ4：サブスクリプションリンクの生成と配布
APIを使ってユーザーのサブスクリプション注文を作成し、サブスクリプション決済リンクを取得します。
⚠️ サブスクリプションリンクの有効期限は24時間です。有効期限内に必ずユーザーへリンクを送付してください。期限切れの場合はAPIで新たにリンクを生成する必要があります。
リンクをユーザーに送付し、ユーザーはクリック後にウォレット接続・引き落とし上限の認可・初回決済を自身で完了できます。
ステップ5：引き落とし通知の受信
コールバックURLを設定すると、以下のイベント発生時にシステムが自動で通知します：
- ユーザーが認可を完了したとき
- 初回引き落としが成功したとき
- 各定期引き落としが成功または失敗したとき
主要ルールの解説
引き落としタイミング
システムは毎日09:00（北京時間／UTC 01:00）に定期引き落としを一括処理します。
初回引き落としのトリガールール
- トライアル期間なし：ユーザー認可後、即時に初回引き落としを実行
- トライアル期間あり：認可後はトライアル期間に入り、トライアル終了後に初回引き落としが自動実行
- 初回特別価格設定時：初回引き落としは特別価格、2回目以降は通常価格
引き落とし失敗時の対応
ユーザー残高不足または認可上限超過で引き落としに失敗した場合：
- システムが6時間ごとに自動リトライ、最大2回まで
- すべてのリトライが失敗した場合、サブスクリプション注文は自動でクローズ
- 再開するには、新しいサブスクリプションリンクをユーザーに発行する必要があります
注文ステータスの説明
td {white-space:nowrap;border:0.5pt solid #dee0e3;font-size:10pt;font-style:normal;font-weight:normal;vertical-align:middle;word-break:normal;word-wrap:normal;}
| ステータス | 意味 |
|---|---|
| Pending Authorization | 注文作成済み、ユーザー認可待ち |
| Authorized | ユーザー認可済み、初回引き落とし待ち |
| In Trial | ユーザーがトライアル期間中、引き落とし未実施 |
| Confirming | 初回引き落とし処理中（トライアル期間なしの場合） |
| Active | 定期自動引き落としが正常稼働中 |
| Completed | 設定した回数または終了日到達でサブスクリプション終了 |
| Canceled | 加盟店がサブスクリプションを任意にキャンセル |
| Unpaid | 引き落とし失敗、システムのリトライ待ち |
| Closed | リトライ上限到達でサブスクリプション終了 |
| Intercepted | オンチェーン取引は成功したが、KYTリスク管理審査で失敗 |
注文の照会・管理
引き落とし記録は以下の方法で確認できます：
加盟店ダッシュボード： 加盟店ダッシュボードにログイン → 決済注文 → 注文タイプ「サブスクリプション決済」で絞り込み
API： /open/v1/order/detail エンドポイントでサブスクリプション注文の詳細を照会
https://docs.gate.com/api-reference/version/100/en/endpoint/subscription/deductionOrderDetail
サブスクリプション画面イメージ
注意事項
- 現時点では既存サブスクリプションプラン（金額・周期等）の編集はできません。変更する場合は新たにプランを作成してください。
- 手数料体系は既存のGate Pay Web3決済ソリューションと同一です。専用のサブスクリプション決済手数料は今後のバージョンで導入予定です。
- 認可時のガス代はユーザー負担、各自動引き落とし時のガス代はプラットフォームが負担します。
免責事項
本コンテンツは参考および教育目的のみであり、金融、投資、取引、または法律に関する助言を構成するものではなく、いかなるデジタル資産の売買の申込みまたは勧誘を構成するものでもありません。Gateは、本コンテンツに含まれる情報の正確性、完全性、適時性について、明示または黙示のいかなる表明または保証も行いません。商品機能、インターフェース、ルール、手数料体系は、いつでも更新または調整される場合があります。最も正確な詳細については、最新のお知らせおよびGateプラットフォーム上に表示される実際の情報をご参照ください。
デジタル資産への投資には重大なリスクが伴い、価格は大幅に変動する可能性があります。投資額の全額を失う可能性があります。関連するリスクを十分に理解したうえで、ご自身の財務状況とリスク許容度に基づき、慎重に判断してください。必要に応じて、独立した専門の金融または法律アドバイザーへ相談することを推奨します。
想定されるリスクの詳細については、Gateのリスク開示およびユーザー契約をご参照ください。
