The following documentation was deprecated. Current version is available at

Xsolla Network

Xsolla Network is a global solution that helps build a game’s brand, acquire new users, and distribute the game through dozens affiliate networks, millions influencers, and hundreds of gaming media portals from one place. Game developers can easily configure and start revenue-sharing or CPA-based campaigns in mere minutes, and, since Xsolla is integrated with all the affiliates, they don’t need to make all those integrations from scratch. Game developers can distribute their offers or messages to influencers and gaming platforms, and pay them right from their Xsolla publisher account, without signing agreements with each of them, thus saving time, money, and R&D resources.

  • User acquisition at no up-front charge
  • You can set the level of advertising at your own discretion, depending on the percentage you’re willing to pay.
  • Xsolla Network has already proven effective in the Life is Feudal success story.
  • 4M Influencers on over 10 the most popular influencing platforms
  • Up to 100 Affiliate Networks
  • News Distribution over all Gaming Media
  • Performance tracking and analytics allow you to analyze your user acquisition campaigns using trackable links, promotional codes, and product activation keys.
  • If you are already integrated with Xsolla Login, you can go without the basic integration offering.

Xsolla Network is a part of Xsolla product ecosystem and can be used alongside Pay Station, Mobile Pay Station and/or Pay2Play. Before start please implement our billing and payments solution.

Interaction Diagram

Xsolla Network

1) The user clicks on the advertising banner and is taken to the Xsolla Proxy page with the information about the game. Xsolla collects all utm parameters from url, including unique event ID (such as Click ID), and generate universal Tracking ID parameter for further communications.

2) With the Tracking ID, saved in users' cookie, the user goes on the Game Landing page.

3) The user starts the registration process in the game. You should save the users' Tracking ID in the game database.

4) You send the information about user registration into Xsolla via API.

5) You should send the users' Tracking ID in the parameters for getting token. When the payment is completed, we save this information in our database.

6) The information that was kept on the first step is sent back with unique user action.

Changes in token request

You should additionally send the information about Tracking ID in the JSON for getting token. Tracking ID is the part of "user" object.

Example request

    curl -v{merchant_id}/token \
    -X POST \
    -u your_merchant_id:merchant_api_key \
    -H 'Content-Type:application/json' \
    -H 'Accept: application/json' \
    -d '
        "user": {
            "id": {
                "value": "1234567"
            "tracking_id": {
                "value": "trackingID"
        "settings": {
            "project_id": 14004

All parameters, which are already included in your JSON for token, should remain the same.

New API request

When the user with a Tracking ID completes the registration process, you should send us the request via API.

Example request

curl -v '{merchant_id}/xsolla_network/
user_register/{tracking_id}' \
-X PUT \
-u merchant_id:merchant_api_key
Parameter Type Description
merchant_id int ID merchant.
tracking_id string Tracking ID.

Example response

HTTP/1.1 204 No Content