How to Set Up the QR Code Login Experience

Welcome! This guide will walk you through setting up a seamless, QR code-based login experience for your clients in-store, similar to the one used by H&M (See the H&M experience).

Important Prerequisites

• Dedicated Device: This setup requires a device dedicated specifically to running the Cloudzet app in your store.

• Private Accounts: Client accounts created via this method are not public. Your clients will not be able to download the Cloudzet app onto their personal devices to log in and access their own scans.

• Account Activation: Before you begin, you must contact the TG3D Team and request to have your company account enabled to support QR code login.

Step 1: Backend Setup and API Integration

To generate the QR codes, you will need to register your clients using our ScanAPI.

• Use the correct API: You must use the "Register by member id" API.

• Target the endpoint: Make a request to POST /api/v1/mtm_users/users/register_member?apikey={apikey}.

• Assign a unique ID: Provide a unique text string in the member_number parameter to identify your client's scan account (this becomes their Cloudzet member ID).

• Format your ID: Avoid using any special characters in this unique text string.

• Map your users: If you maintain a separate membership system, you must keep track of the linkage between the member profile in your system and their new Cloudzet member ID.

• Generate the code: After you have successfully registered an account using the API, take that Cloudzet member ID and encode it into a standard QR Code.

Step 2: Configuring the Cloudzet App

Next, prepare the dedicated device to accept the QR codes.  Please make sure you have the TG3D Team turned on the QR Code support before you proceed with this step.

• Log out: Open the Cloudzet app and ensure you are completely logged out of any current accounts.

• Access store settings: Tap the upper right-hand icon to expand the menu, then select Store settings.

• Log in as the store: Log into your Scanatic™ account (this is the standard account you use to access the Scanatic™ for Fashion portal (https://mtm.tg3ds.com).

• Verify your screen: After you log in, the screen will return to the main dashboard. You should now see a "Create with store" option available.

Phase 3: The In-Store Scanning Experience

Once your backend and app are configured, you are ready to scan clients.

• Open the scanner: Click the scanning button on the upper left-hand corner of the app to access the QR code scanner.

• Scan to log in: Show the generated QR code to the device's front-facing camera. The app will read it and automatically log the account in.

• End the session: After each user session is complete, you will need to manually log the account out to make the app ready for the next user.

NOTE(1):  If you did not pre-register the customer, that is okay, the system will automatically create a new Cloudzet account if the Cloudzet member ID does not exist in the system

NOTE(2): the Cloudzet member ID you used will be listed as "Registered by:" under their scan records on the Scanatic™ for Fashion Portal.  

Mapping the account-related fields to the database

user_id: this is automatically generated by the system

Registered by:  the member ID used for registerer by member API

Nickname: this is the name the customer left with the app when they register the Cloudzet account using the standard process (e-mail, phone number, facebook, apple ID log in)

Real Name: This is when you want to give the customer another name for easier identification.  The Cloudzet use will not be seeing this.

username: is not shown on the Scanatic™ for Fashion Portal but it's usually in the format of member_id@company_id (for example:  25112083@tg3dstudio)