The Single Sign-On (SSO) feature enables new and existing members to register and log in to the Customer Portal and Como mobile app using third-party social providers: Google, Apple, and Facebook. SSO eliminates login friction by offering one-tap access for returning members, auto-filling profile details for new registrations, and providing self-service account management tools.
Table of Contents
1. Overview & Authentication Flows
SSO supports streamlined authentication across desktop browsers, mobile web browsers, embedded webviews, and native mobile app interfaces.
1.1 Returning Member Experience
When a returning member signs in using a linked social provider:
- One-Tap Access: The system recognizes their connected social ID and immediately logs them into their account, bypassing standard password entries or OTP phone verification steps.
-
Authentication Prompts:
- Selecting Google or Facebook opens the provider’s standard web authentication window and returns to the portal or app upon authorization.
- Selecting Apple triggers the native Apple ID authentication sheet.
1.2 Existing Member Social Linking Flow
To link a social account (e.g., Google) to an existing loyalty account, follow these steps:
- Open the Customer Portal or Mobile App login screen.
- Click Continue with Google (or your preferred social provider).
- On the Choose an account page, select the Google account you want to link.
- Enter the Phone Number associated with your existing loyalty profile and click Sign In.
- Enter the Verification Code sent to your phone.
-
If a matching account is detected: The system displays the prompt:
We’ve found the same identifier exists in our database, would you like to merge it? If you choose to merge, some information may be lost.
-
-
If you click YES: The profiles are merged, and you are logged into the portal.
This email you used to authenticate with Google is already linked to an existing phone number of a different loyalty account. If this is a mistake please go back and login using this email address and update your correct phone number. -
If you click NO: The process stops and displays the following message:
Successfully linked your Google account!
- Once authenticated/merged, you will be logged into the portal and displays the confirmation message:
1.3 New Member Experience
When a new member registers using a social provider:
- Phone Verification (OTP): To establish a primary identifier, new members confirm their phone number via a one-time passcode (OTP).
- Pre-Filled Registration Form: Upon consent, profile details supplied by the social provider (First Name, Last Name, and Birthday) automatically pre-fill into the registration form fields.
-
Duplicate Merging Handling: If the email associated with the social provider already exists under a different phone number, the system follows the merchant’s configured Merge Duplicates rule. If duplicate merging is disabled, a clear prompt informs the user that an account already exists with that email address.
- For detailed information on configuring conflict handling, refer to the Merge Flow For Duplicate Users ↗ article.
2. Before You Begin & Prerequisites
To successfully enable and display Social Login on customer-facing tools, the following prerequisite criteria must be met:
- Google Provider Required: Google must be selected as an active provider in the Hub configuration. If Google is unchecked, the entire social login UI remains hidden on web and mobile tools to prevent unresolvable identity collisions caused by missing social email scopes.
-
Phone Number Identifier Required: Phone Number must remain ON, and Login Validation must be checked under its field settings in the Hub. Unchecking Phone Number or disabling its Login Validation automatically forces the system into Custom Login mode and disables Social Login options.
- V2 Registration Form: Merchants must enable the V2 Registration Form setting in HUB 1. (See Section 3: Enabling V2 Registration Form below for setup instructions).
- Mobile App Build Version: Mobile apps must be updated to the required release version to support native social authentication dependencies.
3. Enabling V2 Registration Form (App & Customer Portal Experience)
To ensure the mobile app and customer portal support the social authentication flow and updated layout, you must enable the V2 Registration Form in HUB 1.
Steps to Enable V2 Registration:
- Go to HUB 1.
- Navigate to Branding (NEW) > Design (NEW).
- Locate Registration Version.
- Set the value to v2 = Customer Portal.
- Click Save to save the configuration.
- Navigate to Update App.
-
Click Publish Version to apply the changes that you make in the Como Hub to your app.
Note: After up to a minute of processing, your current app version number increases by 1 (indicating that a new version was published). To view the changes, close and reopen your app.
4. Configuring Social Login in the Hub
Step 1: Navigate to Registration Settings
- Log into the Hub and go to Business Profile > Registration.
- Expand the Advanced Settings section.
- Locate the Member Identity & Validation card.
Step 2: Enable Social Providers
- Select the radio option for OTP & Social Login.
- Under Social Login & Registration, check the boxes for the providers you wish to enable:
- Google (Mandatory requirement)
- Apple
Step 3: Set Provider Display Sequence
The order in which providers are checked inside the Hub directly controls their top-to-bottom sequence on customer-facing login screens across the Customer Portal and Mobile App.
Example: Checking Google, then Apple, then Facebook displays Google at the top, Apple in the center, and Facebook at the bottom.
Step 4: Save Changes
Click Save at the bottom right of the page.
5. Member Profile Management & Self-Service Unlinking
Members retain full control over their connected social accounts directly from their Customer Portal or Mobile App profile:
- Navigate to User Profile and open Social Accounts.
- A modal displays all supported social providers alongside their current status (Connected or Not connected).
- Members can click Unlink next to any active connected provider (e.g., Google) to remove third-party access at any time.
-
If you click Unlink: The system displays the following prompt:
Unlink Google?
You will no longer be able to sign in using this social account. You can link it again at any time.
Important: This does not delete your loyalty account or your data. - If you click NO: The system closes the modal popup.
-
-
Once done, your account will be unlinked and displays the confirmation message:
Successfully unlinked your Google account.
Related Articles & Cross-References
- Primary Login Channel Feature: Instructions on setting up priority for primary verification channels (WhatsApp, SMS, Email) alongside social logins. For detailed information, click here ↗.
- Merge Flow For Duplicate Users: Guide to configuring automated conflict triggers and dynamic update links when matching identifiers are detected. For detailed information, click here ↗.
- App/Customer Portal – Login Validation: Breakdown of SMS, Email, and Custom Login validation methods. For detailed information, click here ↗.
- Customize Your Registration Form: How to manage form fields, required attributes, drop-down options, and country code selectors. For detailed information, click here ↗.