Get started

With this type of integration you will be able to use Xsolla to:

  • Create and manage an item catalog.
  • Create a user authentication system.
  • Manage user access to your application.
  • Store user data in secure Xsolla storage. You can also connect PlayFab, Firebase or your own storage.
  • Provide users with a convenient interface for paying for in-game purchases. Accepting payments and processing transactions is carried out entirely on the Xsolla side.

Interaction between your game and Xsolla

Integration flow

  1. Create and configure a project on the Xsolla side:
    1. Sign up to Publisher Account and create a new project. You will need the ID of the created project in further steps.
    2. Set up a user authentication option in Publisher Account. You will need ID of the created Xsolla Login project in further steps.
    3. Create several virtual items in Publisher Account.
  2. Set up user authentication in your application.
    1. Integrate Xsolla Login into your application. This guide contains instructions on the fastest integration option — integrating a ready-made widget into your application.
  3. Set up catalog:
    1. Implement getting the catalog on the client side of the application using the Xsolla API.
    2. Implement the catalog display in the UI of your application.
  4. Set up item purchase:
    1. Create an order with user and item data from the client side of the application using the Xsolla API.
    2. Implement opening of the payment UI.
  5. Set up order status tracking:
    1. Set up webhooks to validate the user and receive information about order events.
    2. Synchronize your application with Xsolla servers to promptly receive data on successfully paid items and to grant these items to the user on the client side of the application.
Postman collection
Download the collection and test the API calls used for integration.
Note

To complete the integration and start accepting real payments, you are required to sign a licensing agreement with Xsolla.

You can sign the licensing agreement at any integration step, but keep in mind that the signing process can take up to 3 business days.

Your progress
Thank you for your feedback!
Last updated: July 8, 2024

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!