ゲーム内通貨について¶

このドキュメントでは、XGで取り扱うゲーム内通貨について詳しく説明します。

通貨ID¶

ゲーム内で取り扱う各ゲーム内通貨（「gem」、「coin」等）を区別するために使用します。

通貨IDの登録は、XG Developer Site のアプリケーション設定で行います。

ゲーム内通貨の区分¶

XGでは、前払式支払手段の区分管理として、ゲーム内通貨を「有償」と「無償」を分けて管理しています。

有償通貨

これは主に、ユーザーがストア（例：DMM GAMES）で課金アイテムを購入した際に発行されるゲーム内通貨です。
ただし、購入特典のおまけとして発行されるゲーム内通貨は無償通貨として扱われます。
有償通貨は資金決済法の対象となり、各ストアによって有効期間が設定されます。

無償通貨

無償通貨は以下のシナリオで発行されます。
2-1. ログインボーナスやゲームイベントの特典として発行。
2-2. 課金アイテムの購入時のおまけとして発行。

ゲーム内通貨の共有グループ設定¶

各ゲーム内通貨は通常、発行したストアのみ利用できます。
（DMM GAMESで発行したゲーム内通貨は、DMM GAMESのストアで利用可能）

しかし、ゲーム内通貨の共有グループの設定をすれば、その限りではありません。
共有グループの設定で、発行したストア以外でも特定のゲーム内通貨を利用できるようになります。
共有グループの設定は、XG Developer Siteのアプリケーションの設定で定義します。

ゲーム内通貨の消費順¶

ゲーム内通貨の消費順序は、XG Developer Siteのアプリケーションの設定で定義します。

通常の設定では、以下の順序でゲーム内通貨が消費されます。

ストア共有の無償通貨
有償通貨（共有グループ設定に基づく）

有償通貨は以下の順序で消費されます。

有効期限のある有償通貨（有効期限の古いものから）
有効期限のない有償通貨（発行日時の古いものから）

また、「ゲーム内通貨消費API」のリクエスト時に消費するゲーム内通貨を「有償のみ」「無償のみ」に指定できます。

例¶

「ゲーム内通貨の残高」の表では、各ストアで発行したゲーム内通貨の数量を意味します。

「共有グループ設定」の表は、XGアプリケーションでの登録状態です。

上記の設定の場合、「ゲーム内通貨の残高取得API」は次のような結果を返します。

ストアID	有償通貨の所持数	無償通貨の所持数
dmmgames	100gem 50coin	200gem 50coin
appstore	50gem	200gem 50coin
googleplay	30gem	200gem 50coin