Use your own UI
Integration flow
To start selling game keys on the web or in your own application:
- Create game key packages and upload keys.
- Set up selling using one or more of the following methods: direct link, widget, or store interface.
- Sign the licensing agreement with Xsolla.
Additional details:
- The 3-day period covers our initial response or a request for additional information. It doesn’t guarantee that the application will be fully approved within this timeframe.
- If any questions arise during the review, we will contact the person specified in the application.
- Once the review is complete and all requirements are met on Xsolla’s side, the status of your agreement will change to Signed.
Testing game key sales in the test environment (sandbox mode) is available before you sign the licensing agreement.
Selling methods
You can use one method or several at once. The choice depends on what you want to sell:
| Selling method | Item | How it works |
|---|---|---|
| Direct link. | One copy of a game (game key). A bundle of game key packages. | The user follows a link that opens the order page and the payment UI. Item data is passed in the link as query parameters. |
| Widget. | One copy of a game (game key). | The user clicks the buy button and goes to the order and payment window. Item data and the button appearance are set in the widget code. |
| Store interface. | One copy of a game (game key). Several copies of a game (game keys) or different games in a cart. | The user places an order in the interface that you create using the Xsolla Site Builder or Catalog API (selects an item or adds items to the cart). When the user proceeds to payment, a payment token is generated and the payment UI opens. |
Additional features
Authentication
Authentication is not required to sell game keys: the key is sent to the email address that the user specifies when making a purchase. You need to set up authentication if you want to:
- set a limit on game key sales per user
- personalize the item catalog and promotional offers
- use the entitlement system
- store user data in the Xsolla payment UI
An additional authentication step may reduce the purchase conversion rate.
You can authenticate users using the Login product or your own authentication system. For detailed setup instructions, refer to the instructions on setting up authentication for selling game keys.
LiveOps tools
To promote and manage sales, you can use various LiveOps tools, including:
- limiting the display time of a game key package in the catalog, for example, during seasonal sales
- limits on the number of game keys that a user can buy
- personalization of the item catalog and promotional offers
- promo codes.
Activating and deactivating keys
The key is sent to the email address that the user specified when making a purchase, together with activation instructions.
To get access to the game, the user activates the key on the game platform. Activation rules depend on the platform. A user who pre-ordered a game receives the key on the release date that you set and can activate it as soon as the game is released on the platform.
A user can request a refund for purchased keys. Xsolla sends you an email every day with a list of game keys for which the payment refund was successfully completed. DRM Free keys created in Xsolla are deactivated automatically. Keys that you uploaded from outside Xsolla must be deactivated by you.
Found a typo or other text error? Select the text and press Ctrl+Enter.