Account linking

Link additional account for sign in

If you configured multiple user authentication options in your application, you can implement the ability to link an additional social network account or username, email address, and password. This allows users to:

• Use an alternative option to sign into the application, and not the one used during registration. For example, if a user used a device ID to log into the application for the first time, they can add a username, email address, and password and use these authentication details on the same or any other device.

• Use a different account to sign into the application than the one they signed up with. For example, if the user specified a Google account when they first signed into the application, they can also link their Discord account and use their Google or Discord account to sign in.

To implement account linking:

1. In the application UI, add forms for entering data for an additional account.
2. Implement the linking logic using the following Login library methods:

SDK reference documentation

Learn more about SDK methods and its parameters.

Link platform account

If you are distributing your game on different platforms, including Steam, Xbox Live, and Epic Games, you can implement the logic of linking platform accounts to a main user account. This allows users to:

• have one game account for different platforms
• use cross-inventory for synchronizing user inventories on different platforms

Accounts linking flow

1. The user enters the game on the platform for the first time.
2. The game UI shows a message that offers to link the platform account to their main account.
3. The user launches the application and authenticates in their main account.
4. The application sends a request for an account linking code to the Xsolla Login server.
5. The application UI shows the user an account linking code.
6. The user returns to the console version of the game and enters the code.
7. The game server sends the request to link accounts to the Xsolla Login server.
8. The console version of the game shows the confirmation message.

Implementation flow

1. For an application build with a main account to which platform accounts will be linked:
   1. In Publisher Account, set up a standard Login project.
   2. Implement one of the user authentication options:

1. 1. • via username/email and password
      • via device ID
      • passwordless login
      • social login
      • via custom ID

1. 3. In the application UI, add elements for requesting and showing an account linking code.
   4. Implement the logic of requesting the account linking code using the createCodeForLinkingAccount Login library method and showing this code in the application UI.

SDK reference documentation

Learn more about SDK methods and its parameters.

2. For the platform build:
   1. In Publisher Account, set up a shadow Login project.

1. 2. Implement one of the user authentication options:
      • via custom ID
      • silent authentication via a publishing platform

1. 3. In the application UI, add elements for entering an account linking code.

3. On the application server, implement the account linking logic using the Link accounts by code API call.