The CloudMoolah MOO Store is a commercial service that enables people to buy and sell mobile apps. It also provides In-App Purchasing (IAP) services for apps distributed through the store. This guide describes the end-to-end process for a developer adding IAP services to a game that they publish to the CloudMoolah MOO Store.
The MOO Store serves Asian markets including the Philippines, Malaysia, Vietnam, Singapore, and Thailand. Users maintain a digital wallet, which they can fund using a variety of payment providers, such as mobile-pay, banks, and convenience store prepaid cards.
Although compatible with Unity, the CloudMoolah MOO Store is not a Unity product. For more information, see the CloudMoolah Developer Portal website at dev.cloudmoolah.com.
The general workflow for publishing your game to the store and adding IAP to your game is as follows:
Your game must be built as an Android app. For information on building as an Android app, see Getting started with Android development.
To register your game as an available app in the CloudMoolah store:
Sign in to the CloudMoolah Developer Portal.
Click App Listing.
On the App Detail page, enter the following information:
In App Name, enter a name that will identify your game in the CloudMoolah store.
In BundelID, enter the Package name you used for your game in the Unity Editor.
In Currency Name, enter a name for the currency that players will use to complete the in-app purchase.
To create a HashKey that you will use in the initialization code for your app, click GENERATE next to the HMAC/HashKey field.
In the Notification HMAC field, enter the App ID. This value is used during initialization.
Click Save.
An in-app purchase is the transaction of exchanging money for digital goods inside an application. A platform’s store allows users to purchase products, which are digital goods. These products have an identifier, which is typically a string data type.
To add a purchasable item in the CloudMoolah Developer portal:
On the IAP Detail page, enter the following information:
In the ProductID field, enter a string identifier that you will use in your code to enable purchase of the item in your game.
In the Amount field, enter the number cost of the item in the default currency you specified when you registered your game.
In the Product Name field, enter a name for the product.
In the Product Description, enter a description for the product.
The item now appears on the IAP Listing page and you can reference it from your game to offer it to your users.
To configure IAP in your game:
An app targeting the CloudMoolah MOO Store must configure the CloudMoolah appKey and hashKey using the IMoolahConfiguration via the scripting API before initializing Unity IAP. Collect these variables’ values from the app’s CloudMoolah developer dashboard.
The following example configures and starts initialization of Unity IAP:
using UnityEngine.Purchasing;
public class MyStore : IStoreListener
{
public void InitializeStore()
{
var module = StandardPurchasingModule.Instance();
var builder = ConfigurationBuilder.Instance(module);
// Configure CloudMoolah
builder.Configure<IMoolahConfiguration>().appKey = "d93f4564c41d463ed3d3cd207594ee1b";
builder.Configure<IMoolahConfiguration>().hashKey = "cc";
// For server-to-server (also called "online" games) transaction
// logging, set IMoolahConfiguration.notificationURL.
builder.Configure<IMoolahConfiguration>().notificationURL = "https://gameserver.example.com/callback";
builder.Configure<IMoolahConfiguration>().SetMode(CloudMoolahMode.Production);
// Add purchasable products. The product must be defined in the store.
// Unity IAP provides the *ProductType* enumeration to specify the durability
// of a purchasable product. CloudMoolah limits the product type to Consumable.
builder.AddProduct("100.gold.coins", ProductType.Consumable);
// Start asynchronous IAP initialization.
UnityPurchasing.Initialize(this, builder);
}
}
To set the target store in your initialization code, call the UnityPurchasingEditor.TargetAndroidStore function:
UnityPurchasingEditor.TargetAndroidStore(AndroidStore.CloudMoolah);
Note: Take special precautions to safely store your keystore file. The original keystore is always required to update a published app.
For more information on setting up and configuring IAP, see Setting Up Unity IAP, Unity In-App Purchasing Initialization, and Integrating Unity In-App Purchasing with your game.
The CloudMoolah MOO Store supports testing. To test your game in the CloudMoolah MOO Store, you must enable developer mode in the app before making purchases by calling the IMoolahConfiguration.SetMode
function.
When you set the test mode in a build of your game, transactions are processed against a dummy offline store. This allows you to test the app’s purchasing logic without incurring real-world monetary costs related to the product.
To modify the game’s MOO Store test mode, create the ConfigurationBuilder instance and add the following line, then build and run the app to test its IAP logic:
// TESTING: auto-approves all transactions
builder.Configure<IMoolahConfiguration>().SetMode(CloudMoolahMode.AlwaysSucceed);
To test error handling, configure the test mode to fail all transactions. To do this, use the CloudMoolahMode.AlwaysFailed enumeration:
builder.Configure<IMoolahConfiguration>().SetMode(CloudMoolahMode.AlwaysFailed); // TESTING: always fails all transactions
Note: When you finish testing, remove the SetMode statement that configures developer mode, or change the parameter to use the CloudMoolahMode.Production enumeration value. This ensures users pay real-world money when the app is in use.
Unity IAP’s default integration includes an implementation script example that demonstrates how to use the required, and some of the optional, CloudMoolah scripting APIs.
To view the CloudMoolah-specific example:
On your development machine, open the folder for the app in which you have enabled IAP.
Open the Assets/Plugins/UnityPurchasing/script folder.
In the script folder, open IAPDemo.cs.
The example implements the Awake
function, which calls the IMoolahConfiguration
API to set appKey
and hashKey
. This connects your app to the CloudMoolah store server.
The IAPDemo.cs file also shows how to use optional API calls to configure test mode, and for extending functionality to include transaction restoration. For more information on the optional APIs, sign in to the CloudMoolah Developer Portal website at dev.cloudmoolah.com.
2018–03–07 Page amended with limited editorial review