Set up project in Publisher Account
Set up user authentication
Xsolla allows you to configure various ways to authenticate users. This guide contains instructions on the fastest way to integrate and configure it — using a ready-made widget to authenticate the user via a one-time code or via a social network.
Later, you can change the user authentication method or use a different integration option.
Xsolla provides standard widget templates. Their appearance and content is determined by the Login method chosen for your project and widget customization settings from Publisher Account.
Standard widget view for authentication using a one-time code or via social networks:

To set up user authentication in Publisher Account:
- Open your project in Publisher Account.
- In the side menu, click Players > Login.
- Click Create Login project.
- Select Standard Login project and click Create and set up. Wait until your new Login project is created. You will then see the Login project page.
- In the Login methods block, select Passwordless login.
- Click Configure.
- Set up authorization using a one-time code:
- In the Passwordless login block, select Callback URLs.
- In the Callback URL field, add the URL the user is redirected to after successful authentication.
- Click Save changes.
- Set up OAuth 2.0 client:
- Click the name of your Login project in the breadcrumb trail to return to the Login project page.
- Go to the Security block and select the OAuth 2.0 section.
- Click Add OAuth 2.0 client.
- Choose Public authentication type.
- Specify OAuth 2.0 redirect URIs (paths in the application the user is redirected to after successful authentication, email confirmation, or password reset). You can specify multiple valid URIs.
- For desktop or web applications, the URI must start with
https://. By default, the SDK useshttps://login.xsolla.com/api/blank. Specify this URI or use your own. - For Android applications, specify the path as
app://xlogin.<ANDROID_PACKAGE_NAME>, where<ANDROID_PACKAGE_NAME>is the package name of the Android application. - For iOS applications, specify the path as
app://xlogin.<BUNDLE_ID>, where<BUNDLE_ID>is the iOS application identifier.
- Click Connect.
- Set up authentication via social networks (optional):
- Click the name of your Login project in breadcrumb trail to return to the Login project page.
- Go to Authentication block and select Social login.
- Connect social networks that users will be able to use to sign up and log into the application:
- To connect the desired social network, click the ⚙ icon and select Connect.
- To connect several social networks at once, select the required panes (their borders will turn green). Then, from the Manage drop-down menu, select Connect.
- To connect all available social networks at once, click Select all. Then, from the Manage drop-down menu, select Connect.
- Click Save changes.
You can test the widget settings. To do this, click Check now on the left side of the screen and authorize.
During the integration process, you will need:
- Login project ID. You can find it in your project in Publisher Account, in the Players > Login > Dashboard section.
- OAuth 2.0 client ID. You can find it in your project in Publisher Account, in the Players > Login > your Login project > Security > OAuth 2.0 section.
Create items in Publisher Account
You need to create a catalog on Xsolla side. You can add items manually or import them from App Store, Google Play, or PlayFab. When importing from Google Play, you can import a maximum of 100 items at a time.
These instructions provide steps for basic setup of a virtual item. Later, you can add other items to your catalog (virtual currency, bundles, game keys), create item groups, set up promotional campaigns, regional prices, etc.
To add a virtual item with basic settings to the catalog:
- Open your project in Publisher Account and go to the Items catalog > Virtual items section.
- In the drop-down menu, select Create item.
- Set the basic settings of the item in the following fields:
- Image (optional)
- SKU (item unique ID)
- Item name
- Description (optional)
- Specify item price:
- Set the Price in real currency toggle to On.
- In the Default currency field, change the currency (optional) and specify the item price.
- If you changed the currency in the Default currency field, select the same currency in the Price in real currency field.
- Change the item status to Available.
- Click Create item.
Found a typo or other text error? Select the text and press Ctrl+Enter.