Set up user authentication via Xsolla Wallet account

To set up user authentication with Xsolla account:

  1. Create a Login project in Publisher Account.
  2. Create an Xsolla account OAuth 2.0 client.
  3. Enable Xsolla as a social network.

Create Login project

  1. In your project in Publisher Account, go to the Login section.
  2. Click Create Login project.
  3. Select Standard Login project and click Create and set up. Once your new Login project is created, you can see the page with Login project settings.

During the integration process, you will need your Login ID. To get it, click the name of your Login project in breadcrumb trail to return to the Login project page, and click Copy ID beside the name of the Login project.

Notice

When you create a Login project for Metaframe, the Callback URLs section is configured automatically. Do not remove automatically added URLs from the Callback URL and Allowed origins (CORS) lists.

Create Xsolla account OAuth 2.0 client

Contact the integration team at integration@xsolla.com or your Customer Success Manager at csm@xsolla.com and provide the following information:

ParameterTypeExampleDescription
Redirect URIsArray of strings[“https://example.com/oauth/callback”, “http://localhost:3000/oauth/callback”]A list of URI addresses that can be used for redirecting the user after authentication through Xsolla account.
AudienceString“https://example.com”The domain where users can log in via Xsolla account.
ScopeArray of strings[“email”, “transactions”]List of permissions in Xsolla account.
The Xsolla integration team will create an Xsolla account OAuth 2.0 client for you and provide its identifier and secret key. This data is necessary to enable Xsolla as a social network.

Enable Xsolla as social network

  1. In your project in Publisher Account, go to the Login section.
  2. Click Configure in the pane of a Login project.
  3. In the Login methods block, select Social login.
  4. Click Configure.
  5. Select Xsolla from the list of social networks.
  6. Click the icon and select Settings.
  7. Fill in the following fields:

    • Application ID — the Xsolla account OAuth 2.0 client identifier you received from Xsolla.
    • Application secret key — the Xsolla account OAuth 2.0 key you received from Xsolla.
    • Your website link — the website from which requests for exchange of authorization code exchange for a user authorization token will be sent. Specify the same URL address that was indicated as the Audience parameter when creating the Xsolla account OAuth 2.0 client.

  1. Click Connect.
  2. Click back to Social Networks.
  3. Set the Embed social network JWT token toggle to On.
  4. Click Save changes.
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: January 15, 2025

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!