サブスクリプション¶

サブスクリプション機能に関するよくある質問と回答です。

どのストアのどのサービスに対応していますか？¶

XGサブスクリプションは、以下のストアのサービスに対応しています。

ストア	対応サービス
App Store	サブスクリプション
Google Play	定期購入
DMM GAMES	定期購入（月額決済サービスには非対応）

詳細は概要を参照してください。

サブスクリプションの購入方法は？¶

サブスクリプションの購入処理は、基本的な課金アイテム購入と同様の流れです。

ストアでサブスクリプション商品を購入後、ゲームサーバーでサブスクリプション購入検証APIと購入APIを呼び出し、XGサブスクリプション通知を受信して利用権を付与します。

詳細はサブスクリプションシーケンスを参照してください。

サブスクリプションの更新処理はどうすればいい？¶

サブスクリプションの状態変更（継続、キャンセル、有効期限切れ等）は、XGサーバーからゲームサーバーへ通知されます（XGサブスクリプション通知）。

ストアごとの処理方法が異なります。App Storeは継続時に新しいtransactionIdが発行されるため、ゲーム端末の未処理レシートもしくはApp Storeサーバー通知で処理します。Google PlayとDMM GAMESは、XGがサーバー通知を受信するか、バッチ処理で更新を検知して処理します。

詳細はサブスクリプションシーケンスを参照してください。

XGサブスクリプション通知の処理方法は？¶

XGサブスクリプション通知は、XGサーバーからゲームサーバーに送信されるサブスクリプション状態の変更通知（購入、継続、キャンセル、返金など）です。

通知受信時の処理フローは以下の通りです。

署名検証: signedTransaction を公開鍵で検証・デコード
重複チェック: transactionId で処理済みかどうかを確認
利用権処理: itemAction に応じて利用権を付与・回収（または処理なし）
サブスクリプション情報の保存: subscriptionStatus や transactionId などを保存
レスポンス返却: 成功時は subscriptionTag を返却

XGサブスクリプション通知の処理方法は、バッチ処理（基本となる処理方法）とゲーム端末からの処理（ゲームプレイ時の処理方法）の2種類があります。

詳細は XGサブスクリプション通知およびサブスクリプションシーケンスを参照してください。

サブスクリプションの有効・無効はどう判断する？¶

XGサブスクリプション通知に含まれる subscriptionStatus でサービス利用可否を判断してください。

利用可: active / canceled / grace_period
利用不可: on_hold / expired / paused / revoked

サービス利用不可の場合は、利用権を無効として扱ってください（コンテンツのロック等）。

各状態の詳細は用語集の「サブスクリプション状態」、イベントとの対応は XGサブスクリプション通知のサブスクリプション状態変更イベントと利用権処理を参照してください。

利用権の付与・回収・無効化の違いは？¶

付与（grant）: XGサブスクリプション通知に含まれる itemAction が grant の場合、アイテム付与やコンテンツのアンロック等を行います
回収（revoke）: XGサブスクリプション通知に含まれる itemAction が revoke の場合、返金等により付与済みのアイテムを回収します
無効化: サブスクリプション状態がサービス利用不可の場合、サービス利用を制限します（コンテンツのロック等）。アイテム回収は発生しません

詳細は XGサブスクリプション通知の利用権の付与・回収・無効化を参照してください。

XGサブスクリプション通知のテスト通知と通常の通知の違いは？¶

XG Developer Siteからテスト通知を送信した場合、以下の点が通常の通知と異なります。

リクエストボディに testNotification フィールドが含まれます
signedTransaction のJWSペイロードには xgProjectId 、 xgApplicationId 、 environment のみが含まれます。 event や transactionId などの項目は含まれません