Headless Configuration Guide

1. Overview

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.

2. Prerequisites

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

3. Setup Instructions

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

\