はじめに
統合フロー
サブスクリプションを統合するには：
- ゲームのプロジェクトを作成します。
- サブスクリプションプランをセットアップします。
- 認証をセットアップします。
- カタログUIを作成します。
- 決済UIを開く方法をセットアップします。
- サブスクリプション情報の取得を実装します。
- ライセンス契約に署名します。
どのように動作するか
サブスクリプションの購入
継続的なサブスクリプションの自動更新
ユーザーフロー
用語集
サブスクリプションプラン
サブスクリプションベースの製品
ユーザーがサブスクリプションを購入したときに提供されるサービスまたはサービスのセット。製品の作成APIコールは、製品の作成に使用されます。サービスごとに個別のサブスクリプションの販売を設定する場合や、ユーザーが同時に複数のサブスクリプションを取得できるようにする場合は、製品の作成が必要です。サブスクリプションベースの製品には、ストリーマーのチャンネル、ゲーム、またはユニークアイテム/ユニークアビリティへのアクセスなどがあります。サブスクリプションベースの製品の設定と使用について詳しくは、こちらの説明をご覧ください。
サブスクリプション
製品と選択されたプランの組み合わせです。サブスクリプションは、ユーザーがサブスクリプションプランを選択し、サービスへのアクセスを取得すると作成されます。ユーザーが同時に取得できるサブスクリプションの数は、プロジェクト内の製品の数に依存します。サブスクリプションの条件（請求期間、コスト、その他）は、選択されたプランの条件に対応します。既存のサブスクリプションの条件は、サブスクリプションの作成後にプランの条件が変更されても変更されません。
例1
製品：ゲームへのアクセス
- サブスクリプションプラン
Silver ：1ヶ月あたり10ドル - サブスクリプションプラン
Gold ：1年あたり100ドル
ユーザーは次のサブスクリプションのいずれかを選択できます：
- サブスクリプション1：月額10ドルプランのゲームへアクセスする
- サブスクリプション2：年間100ドルプランでのゲームへアクセスする
例2
製品1：ゲーム1へアクセスする
製品2：ゲーム2へのアクセス
- サブスクリプションプラン：1か月あたり10ドル
ユーザーは2つのサブスクリプションを同時に取得できます：
- サブスクリプション1：月額10ドルプランでgame1にアクセスする
- サブスクリプション2：月額10ドルプランでgame2にアクセスする
プランのグループ
同じgroup_idパラメータ値を持つプランのセット。
グループを作成または変更するには、group_idパラメータを以下のAPIコールに渡します：
以下の場合は、プランのグループを作成する必要があります：
サブスクリプションベースの製品を作成する
製品サブスクリプションとして選択できるプランの数を制限する
ユーザーがグループ内の別のプランに切り替えられるようにする
グループの設定と使用について詳しくは、こちらの説明をご覧ください。
試行期間
- 試用期間付きのサブスクリプションを購入すると、請求書作成用のアカウントが作成され、認証決済が行われます。ユーザーのアカウントから少額が請求され、その後、返金されます。決済が発生しても、ウェブフックURLに決済ウェブフックは送信されません。
- 試用期間終了後、サブスクリプションプランの全費用が請求され、決済および最新のサブスクリプションウェブフックがウェブフックURLに送信されます。サブスクリプションの決済に失敗した場合は、キャンセルされたサブスクリプションウェブフックが送信されます。試用期間はプランの有効期間には含まれず、その期間は別途計算されます。
- キャンペーンの特典として試用期間を設けることができます。
猶予期間
- 猶予期間は、通常プランおよび一括払いのサブスクリプションにのみ利用できます。自動支払い更新タイプのサブスクリプションは、自動的に請求されます。
- エクソーラは、猶予期間の有効化時およびその後の猶予期間の毎日に、支払いの必要性をユーザーに通知します。
- ユーザーが猶予期間中にサブスクリプションの支払いを行った場合、支払いは全支払期間に対して行われます。
- ユーザーが実際の支払いなしでパートナーのサービスにアクセスできる日数は、サブスクリプション期間の合計日数から差し引かれます。
- プラン設定の猶予期間フィールドの値が
0の場合、プランには猶予期間がありません。
再試行期間
- 再試行期間は、通常プランおよび自動支払いのサブスクリプションにのみ適用されます。
- 請求は、保存されている支払いアカウントから1日に1回行われます。
- システムは、サブスクリプションが更新されるか、ユーザーによってキャンセルされるか、課金再試行回数を超えてキャンセルされるまで課金を試みます。
- ユーザーが再試行期間の終了前にサブスクリプションを更新した場合、ユーザーが実際の支払いなしでパートナーのサービスにアクセスできる日数が、サブスクリプション期間の合計日数から差し引かれます。
- プラン設定の「請求の再試行回数」フィールドの値が
0の場合、プランには再試行期間がありません。
自動払い
1回払い
サブスクリプションの状態
サブスクリプションのステータスは、次のいずれかです。
- 有効。プライマリステータス。サブスクリプションは、最初の決済が成功した後に作成され、有効化されます。有効なサブスクリプションでのみ追加料金が発生します。
- キャンセル済み。次のいずれかの理由により、サブスクリプションはキャンセルされ、即時に有効になります：
- APIメソッドまたはエクソーラアドミンページからステータスが変更されました。
- ユーザーによりキャンセルされました。
- 期限切れ、パラメータに有効期限が設定されている場合。
- 請求の最大試行回数を超えました。これはデフォルトでは3回です。変更するには、カスタマーサクセスマネージャーまでお問い合わせるか、csm@xsolla.comに電子メールを送信してください。
- ゲームでユーザーが見つかりません。
- ユーザーアカウントが削除されました。
- 更新なし。サブスクリプションの更新がキャンセルされました。サブスクリプションは、ステータスがキャンセル済みに変わる前に現在の請求サイクルが終了するまで続きます。以下のいずれかの理由により、更新をキャンセルすることができます：
- APIメソッドまたはアドミンページからステータスが変更されました。
- メールリンクを介してユーザーによってキャンセルされました。
- ユーザーアカウントが削除されました。
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
