Skip to main content

Single Sign-On

Does Topper support Apple and Google Single Sign-On?

Yes.

What are the benefits of using Single Sign-On?

Single Sign-On (SSO) is a secure authentication system that reduces the burden of login for the users, by enabling them to sign in with their Apple or Google account.

This creates a better experience for users because they can use their existing credentials to authenticate and don't have to enter credentials and validation codes.

Cross-platform support

Web

BrowserScenarioApple SSOGoogle SSO
Chrome (and others)Desktop
Chrome (and others)Mobile

Electron

Apple SSOGoogle SSO

Mobile App

OSScenarioApple SSOGoogle SSO
AndroidWebview
iOSWebview
AndroidWebview with an iframe
iOSWebview with an iframe

Notes:

  • If you are redirecting to Topper through the user's browser, no extra configuration is necessary.
  • When Topper is embed with a WebView, ensure setting is_android_webview=1 or is_ios_webview=1 as a query parameter in the URL.
Deprecated Parameters

The parameters is_ios_app and is_android_app are now renamed to is_ios_webview and is_android_webview.

Legacy parameters are still supported but deprecated.

Please migrate to the new parameter names to ensure future compatibility.

Example URLs:

  • Android: https://app.topperpay.com/?bt=<bootstrap token>&is_android_webview=1
  • iOS: https://app.topperpay.com/?bt=<bootstrap token>&is_ios_webview=1

Using the Web SDK:

  • Android: topper.initialize({ bootstrapToken: <bootstrap token>, { is_android_webview: true } });
  • iOS: topper.initialize({ bootstrapToken: <bootstrap token>, { is_ios_webview: true } });