Headless Configuration

Headless configuration allows your mobile app to connect directly with Shopify Customer Account API, enabling passwordless login (OTP / magic link). This helps reduce friction and improve conversion rates.

Before getting started, make sure:

• Your store is using Customer Accounts (New version)

• You have Admin access to the Shopify store

• You can access the Ego Mobile Builder Dashboard

Step 1: Enable Headless in Shopify

1. Go to Shopify App Store

2. Install Headless

👉 If you don’t see this option, your store may not support it or Customer Accounts (new version) is not enabled.

Step 2: Create Storefront API

1. In the Headless page

2. Click Create Storefront

✅ Result:

• A Storefront API is created for your mobile app connection

Step 3: Access Customer Account API

1. In the Headless page

2. Locate Customer Account API

3. Click Manage

Step 4: Configure Client Type

1. In the Customer Account API settings:

2. Select Client type = Confidential

1. In Application setup, locate Callback URI(s) (required)

2. Add the following URL:

https://mobile.opusecom.co/api/v1/auth-store/callback

1. Ensure the URL is entered correctly (no extra spaces or typos)

📌 Explanation:

A Confidential client allows the use of a Client Secret, which is required for secure authentication in mobile apps

Step 5: Save & Retrieve Credentials

1. Click Save

2. The system will display:

3. Client ID

4. Client Secret

⚠️ Important:

• The Client Secret is shown only once

• Save it immediately (recommended: password manager or secure vault)

Step 6: Configure in Ego Mobile Builder

1. Go to Ego Mobile Builder Dashboard

2. Navigate to Settings → Customer Account → No-password Login

3. Enter:

4. Client ID

5. Client Secret

6. Click Save