GS2-Money

ウォレット新規作成時

ウォレット新規作成時に呼び出されます。 このイベントが発生した瞬間にはまだウォレットの作成は実行されておらず、スクリプトの結果として「作成を許可しない」というレスポンスを返すことが出来ます。 また、このスクリプトをレスポンスした後、何らかのエラーが発生した場合には、ウォレットの作成が失敗する可能性があります。

Request

{
  moneyName=[string] GS2-Money の仮想通貨名,
  userId=[string] ユーザID,
  slot=[number] スロット番号,
  accessToken=[string] アクセストークン
}

Response

{
  permit=[bool] ウォレットの作成を許可するか,
  (initialAmount=[number] ウォレットの初期残高 - 無償付与として加算されます)
}

ウォレット新規作成完了時

ウォレットの新規作成が完了した時に呼び出されます。 このイベントが発生した瞬間にはウォレットの永続化が完了されていることが保証されています。

Request

{
  moneyName=[string] GS2-Money の仮想通貨名,
  userId=[string] ユーザID,
  slot=[number] スロット番号,
  paid=[number] 有償課金通貨残高,
  free=[number] 無償課金通貨残高,
  accessToken=[string] アクセストークン
}

ウォレット残高加算時

ウォレットに残高を加算する際に呼び出されます。 このイベントが発生した瞬間にはまだウォレットへの残高の加算は実行されておらず、スクリプトの結果として「加算を許可しない」というレスポンスを返すことが出来ます。 また、このスクリプトをレスポンスした後、何らかのエラーが発生した場合には、ウォレットの加算が失敗する可能性があります。

スクリプトの戻り値として「実際に適用する加算量」を返すことで、強制的に加算量を変更することが出来ます。

Request

{
  moneyName=[string] GS2-Money の仮想通貨名,
  userId=[string] 新しく作成するユーザのID,
  slot=[number] スロット番号,
  transactionId=[string] トランザクションID
  count=[number] 加算量,
  price=[number] 購入価格,
  accessToken=[string] アクセストークン
}

Response

{
  permit=[bool] ウォレットへの加算を許可するか,
  (overrideCount=[number] 実際に適用する加算量)
}

ウォレット残高加算完了時

ウォレットへの加算が完了した時に呼び出されます。 このイベントが発生した瞬間にはウォレットへの加算が完了されていることが保証されています。

Request

{
  moneyName=[string] GS2-Money の仮想通貨名,
  userId=[string] 新しく作成するユーザのID,
  slot=[number] スロット番号,
  transactionId=[string] トランザクションID
  count=[number] 加算量,
  price=[number] 購入価格,
  paid=[number] 有償課金通貨残高,
  free=[number] 無償課金通貨残高,
  accessToken=[string] アクセストークン
}

ウォレット残高消費時

ウォレットに残高を消費する際に呼び出されます。 このイベントが発生した瞬間にはまだウォレットへの残高の消費は実行されておらず、スクリプトの結果として「消費を許可しない」というレスポンスを返すことが出来ます。 また、このスクリプトをレスポンスした後、何らかのエラーが発生した場合には、ウォレットの消費が失敗する可能性があります。

スクリプトの戻り値として「実際に適用する消費量」を返すことで、強制的に消費量を変更することが出来ます。

Request

{
  moneyName=[string] GS2-Money の仮想通貨名,
  userId=[string] 新しく作成するユーザのID,
  slot=[number] スロット番号,
  transactionId=[string] トランザクションID
  count=[number] 消費量,
  price=[number] 購入価格,
  accessToken=[string] アクセストークン
}

Response

{
  permit=[bool] ウォレットへの消費を許可するか,
  (overrideCount=[number] 実際に適用する消費量)
}

ウォレット残高消費完了時

ウォレットへの消費が完了した時に呼び出されます。 このイベントが発生した瞬間にはウォレットへの消費が完了されていることが保証されています。

Request

{
  moneyName=[string] GS2-Money の仮想通貨名,
  userId=[string] 新しく作成するユーザのID,
  slot=[number] スロット番号,
  transactionId=[string] トランザクションID
  count=[number] 消費量,
  price=[number] 購入価格,
  paid=[number] 有償課金通貨残高,
  free=[number] 無償課金通貨残高,
  accessToken=[string] アクセストークン
}