GS2-Money2 API Reference

This service manages premium currency, the in-game resource that carries a value equivalent to real money.

Billing currency refers to in-game currency that falls under the category of prepaid means of payment (home-grown) as defined by Japan’s Funds Settlement Act. To comply with the Funds Settlement Act, GS2-Money2 does not manage a balance as a simple quantity; it keeps the quantity separated by the unit price at the time of purchase. For example, 100 units bought for 100 JPY are held at a unit price of 1 JPY, while 1,200 units bought for 1,000 JPY are held at a unit price of 0.8334 JPY. A single wallet can also hold currency purchased in multiple settlement currencies, such as JPY and USD, so that revenue and consumption can be tracked per currency.

Every deposit and withdrawal is recorded as a transaction, and the unused balance is aggregated several times a day so that it can be used for the deposit obligation of prepaid means of payment.

Receipts issued by the Apple App Store and Google Play are verified before the balance is granted, checking both their authenticity and whether they have already been used, which prevents fraudulent deposits. During development, dummy receipts (fake) can be used instead. Store subscriptions are also supported, and the start, renewal, and expiration of a contract are reflected automatically. A subscription contract can be taken over by another account, which covers cases such as family sharing or migrating from a child account to an adult account.

Paid currency and free currency granted through campaigns are managed separately within the same wallet, and you can choose whether to consume the free balance or the paid balance first. When paid currency is consumed, it is consumed in order from the oldest deposit.

If you do not wish to share a wallet between different platforms, we also provide a mechanism to separate wallets within the same account by slot, depending on the platform from which the player is accessing. This addresses the platform guidelines that prohibit bringing in currency purchased on another platform. Even in that case, the free offering can be shared between different platforms.