GS2-Money2 の提供を開始しました。

はじめに

GS2-Money は課金通貨の残高を管理するマイクロサービスです。

機能追加の背景

GS2-Money は課金通貨の残高を管理するマイクロサービスですが、1つのネームスペースで1つの通貨（日本円/米ドルなど）しか扱えないため、グローバル展開する際の扱いが難しいという課題がありました。

新しいマイクロサービスの特徴

原則 GS2-Money とほぼ同じ仕様を持ちますが、ウォレットに複数種類の通貨でチャージした結果を保持できるようになりました。
ウォレットのフォーマットが変わっているため、GS2-Money の新機能というよりは、GS2-Money というマイクロサービス自体を新しくした方が混乱がないであろうということから、マイクロサービスレベルでこれまでとは別のサービスとして提供開始しました。

実装例

残高加算の入手アクション

{
    "action": "Gs2Money2:DepositByUserId",
    "request": {
        "namespaceName": "[string]ネームスペースの名前",
        "userId": "[string]ユーザーID",
        "slot": "[int]スロット番号",
        "depositTransactions": [
            {
                "price": "[float]購入価格",
                "currency": "[string]通過コード",
                "count": "[int]所持量"
            }
        ]
    }
}

GS2-Money では price / depositCount というフィールドでしたが、
currency が追加され、ここに「JPY」「USD」のような通貨コードを格納できるようになりました。

depositTransactions が配列になっているのは、GS2-Money2 で管理する課金通貨から GS2-Money2 で管理する二次通貨にチャージする際に複数の通貨がソースになる可能性があるためです。