Account Linking

Account linking connects a player's webshop session with their game client.

The webshop launches the game through a deep link (on mobile) or a QR code (on desktop). The deep link carries a session code. The game client attaches the player's authentication data to this code and sends both to the Stash API to complete login.

Deeplink setup

Set up the login deep link on the App Login page in Stash Studio. Use a URL scheme that clearly represents your game, and register it in your game client on each platform. For example, the demo app uses howlingwoods://.

Integrate account linking

The example below uses Unity, but you can follow the same flow in other engines such as Unreal Engine, Godot, or custom web/native clients.

Refer to your engine's documentation for handling deep links. The game client extracts the code and forwards it to your game server. The server completes the link by calling ApproveCustomLogin.

Login code rules

• Lifetime. A code is valid for 10 minutes from when the webshop creates it. Approve it inside that window.
• Single use. A code can be approved once.
• Format. The code is URL-safe base64 and can end in =. Pass it to ApproveCustomLogin exactly as it appears after code= in the link.

ApproveCustomLogin answers:

Set up account linking in Unity

Use the Stash SDK to integrate account linking in Unity.

The SDK is optional. It provides convenient wrappers around the API endpoints, but you can also implement account linking with direct API calls.

Import the Stash SDK

Follow these steps to add the Stash SDK to your Unity project:

Set up deep links

See the Unity deep linking overview for platform-specific instructions.

Let's take a look at the structure of the Stash's deep links.

stashggsample://login?code=<code>

The key element in the link is the code. Configure deep links correctly and add logic to extract the code when your game launches through a deep link.

Extract the code

With deep linking configured, you can extract the code.

Use Unity's Application.deepLinkActivated event to handle deep link activations. This event triggers whenever the game launches or resumes from a Stash deep link.

In the onDeepLinkActivated handler, split the link to extract the code.

public void onDeepLinkActivated(string url) {
  // Extract the code parameter from the link.
  var code = url.Split("login?code=")[1];
  if (!string.IsNullOrEmpty(code)) {
    // Work with code...
  }
}