Pre-Registration Process

Pre-registration streamlines merchant onboarding by storing OAuth credentials upfront, eliminating manual credential exchange and reducing errors.

Access the Pre-Registered Tab

1. Navigate to Channel Dashboard → Merchants

2. Click the "Pre-Registered" tab (second tab, after "Connected Merchants")

3. Click the "Add Pre-Registration" button to begin

The Pre-Registered tab displays a table of all merchants awaiting installation:

• Merchant Name: Display name for this merchant

• Store URL: The merchant's Shopify store URL (*.myshopify.com)

• Merchant ID: Unique identifier assigned by Violet (format: mrc_abc123)

• Actions: Menu for managing pre-registration

Pre-Registered Merchants Table

The Actions menu (⋮) provides:

• Copy Violet Connect Link (Recommended) — Provides fastest merchant onboarding with merchant-specific credentials pre-filled

• Copy Install Link — Direct Shopify authorization link (alternative flow)

• Edit — Update merchant details or credentials

• Delete — Remove pre-registration (use if merchant is no longer onboarding)

When a merchant completes onboarding, they automatically move from the "Pre-Registered" tab to the "Connected Merchants" tab.

Add Pre-Registration Form

When you click "Add Pre-Registration", fill in the following required fields:

Field	Description	Where to Get It
Merchant Name	Display name for this merchant	Your choice (e.g., merchant's business name)
Store URL	The merchant's Shopify store URL	Ask merchant for their *.myshopify.com URL (e.g., acme.myshopify.com)
Client ID	OAuth client identifier	Shopify Partner Dashboard → Apps → Your Custom App → API credentials tab
Client Secret	OAuth secret key	Shopify Partner Dashboard → Apps → Your Custom App → API credentials tab (shown only once)
Install Link	Merchant-specific installation URL	Shopify Partner Dashboard → Apps → Your Custom App → Configuration tab → Generate install link

Validation:

• All fields are required

• Store URL must be in the format *.myshopify.com

• Client ID and Client Secret must be valid

After Submission

After creating the pre-registration, you'll see a success modal displaying:

• Confirmation message with merchant name

• Assigned Merchant ID (format: mrc_abc123)

• Violet Connect link for this merchant (format: https://connect.violet.io/oauth?merchantId=mrc_abc123)

Copy this link and send it to your merchant. This is the recommended link — it provides the fastest onboarding experience with pre-filled merchant details.

Getting the Installation Link

From the Pre-Registered Tab

Once you've pre-registered a merchant, you can retrieve their installation link at any time:

1. Navigate to Channel Dashboard → Merchants → Pre-Registered tab

2. Find the merchant in the table

3. Click the actions menu (⋮) for that merchant

4. Click "Copy Violet Connect Link" (recommended) or "Copy Install Link"

5. Send the link to your merchant via email, Slack, or your preferred communication method

Which Link to Send?

Two types of links are available for merchant installation:

Link Type	When to Use	Merchant Experience	Recommended
Violet Connect Link	Most cases	Fastest — merchant authenticates with Violet first, pre-filled store details, one-click connection to Shopify	✅ Yes
Shopify Install Link	When merchant prefers Shopify-first flow	Merchant authorizes Shopify first, then completes Violet authentication	Alternative

Recommendation: Use the Violet Connect link for the most streamlined merchant experience. This path requires the fewest steps and provides the fastest onboarding (under 2 minutes).

---

Next step: Learn about the three merchant onboarding paths so you understand what happens after you send the link.