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.
4. Set up callback URLs.

Create Login project

1. Open your project in Publisher Account.
2. Click Login in the side menu.
3. Click Create Login project.
4. 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.

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:

Parameter	Type	Example	Description
Redirect URIs	Array 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.
Audience	String	“https://example.com”	The domain where users can log in via Xsolla account.
Scope	Array 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. Open your project in your Publisher Account and 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:

1. • 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.

8. Click Connect.
9. Click back to Social Networks.
10. Set the Embed social network JWT token toggle to On.
11. Click Save changes.

Set up callbacks URLs

1. Go to the Callback URLs tab.
2. Make sure that the following URLs are added in the Callback URL section:
   • https://login-widget.xsolla.com/latest/babka-auth-succeed
   • https://login.xsolla.com/api/social/oauth2/callback
3. In the Allowed origins (CORS) section:
   1. Make sure that the https://metaframe.xsolla.com value is added.
   2. Add the URLs of the domain where the Metaframe widget will be used.
4. Click Save changes.

Last updated: October 9, 2024