Get started

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

  • Create and manage an item catalog.
  • 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.

You will need to implement yourself:

  • User authentication system.
  • The logic for determining the user’s country and currency to pay for the purchase.

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. Create several virtual items in Publisher Account.
  2. Set up catalog.
    1. Implement retrieval of the catalog using the Xsolla API.
  3. Set up item purchase:
    1. Create an order with user and item data on the client side of the application using the Xsolla API.
    2. Implement opening of the payment UI.
  4. 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.
Notice

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.

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Last updated: July 18, 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!