We have partnered with Xsolla to offer you the possibility to integrate in-game purchases more conveniently.
In-game purchases are an invite-only feature. If you are interested in using them, please get in touch with us.
When using the Xsolla SDK/API, you will need one of the following ways of authentication:
- The token received from the
getXsollaUserToken()method from the SDK. This method generates a custom Xsolla token that you use with the Xsolla SDK/API. The purchases are linked to the CrazyGames user account. This is applicable for Scenario 2 and Scenario 3.
- Alternatively, we can invite you to our Xsolla account, so that you generate the necessary Xsolla credentials on your own, and use the SDK/API with the generated credentials. Purchases will be linked to your in-game user accounts. This is applicable only for Scenario 3. You can also skip the rest of this guide.
In-game purchases should be available only for the users that are signed in. Guest users should not be able to purchase items.
Get Xsolla token
If you would like to use Xsolla via our own custom-generated token, you can retrieve the Xsolla token like this:
We recommend that you retrieve the token every time before using it, since the tokens are usually short-lived, for example only 1 hour. Our SDK handles the token refresh.
After retrieving the token, you can use it like this:
Check Xsolla API for more functionality.
You don't need to handle any Xsolla login functionality, since Xsolla will automatically handle the user account creation with the user ID included in the token, which is the ID of the CrazyGames user. Thus, all the purchases made using the token will be also linked to the CrazyGames user account.
getXsollaUserToken() method will work only in the QA tool or CrazyGames.com. Please notice that the QA Tool can be accessed either from the sidebar of the developer portal (standalone QA Tool) or when editing your game. The Xsolla token generation will work only in the QA tool that is accessed from the game since it requires your game id.
For the initial testing, we recommend testing with sandbox orders, which allow purchasing items with fake money. When you submit the game, please ensure the sandbox orders are disabled.