Merchant Onboarding
After you've pre-registered a merchant in the Channel Dashboard, they complete onboarding through a single Violet Connect flow that handles both account creation and Shopify app installation. This page explains what the merchant experiences.
The Onboarding Flow
Your Steps (Channel)
Pre-register merchant in Channel Dashboard with Store URL, Install Link, Client ID, and Client Secret
Copy the Violet Connect link from the Pre-Registered tab (Actions menu → Copy Violet Connect Link)
Send Violet Connect link to merchant
Merchant Onboarding Experience
The merchant receives your Violet Connect link and completes the entire onboarding in one seamless flow:
1. Open the Violet Connect Link
Merchant clicks the Violet Connect link you sent
They're taken to the Violet Connect onboarding page
2. Authenticate with Violet
Enter email address
Receive and enter 6-digit verification code
3. Review Pre-filled Details (Store Found)
Because the Violet Connect link contains the encoded pre-registration data, the merchant is taken directly to the "Store Found" screen
They see their store name and URL already filled in
Pre-registration detected automatically
4. Install the Shopify App
Merchant clicks the "Connect to Shopify" button
They're redirected to Shopify to authorize the app installation
Merchant sees the "Install app" confirmation screen showing your app name and required permissions
Important: When installing the app, merchants should leave "Embed app in Shopify admin" unchecked (it's checked by default).
Merchant clicks "Install" button
5. Return to Violet Connect
After installation, merchant is automatically redirected back to Violet Connect
Violet completes the OAuth handshake in the background
6. Complete Setup
Set up payout account (if required)
Configure commission settings (if applicable)
7. Done!
Store is connected
Merchant automatically moves to your Connected Merchants tab
You receive webhook notification of successful connection
Why This Flow Works
✅ Single link
Merchants only need one link to complete the entire process
✅ Seamless
App installation happens within the Violet Connect flow
✅ Fast
Entire onboarding takes just a few minutes
✅ Error-free
No manual credential entry or typos
✅ Pre-configured
All OAuth settings handled during pre-registration
✅ Trackable
Real-time status updates in your Channel Dashboard
✅ Secure
OAuth credentials never exposed to merchant
Alternative Path: Store URL Lookup
If a merchant loses the Violet Connect link or navigates directly to https://connect.violet.io/{your_app_alias}:
Merchant creates an account or logs in
Merchant selects "Shopify" as their platform
Merchant enters their store URL (e.g.,
acme.myshopify.com)Violet detects the pre-registration and shows "Store Found" confirmation
Merchant clicks "Connect to Shopify" and is redirected to Shopify for app installation
After installation, merchant is redirected back to Violet Connect to complete setup
When to use this path: If a merchant loses their Violet Connect link, they can still complete onboarding by entering their store URL manually.
Behind the Scenes
When a merchant completes onboarding, Violet automatically:
Completes OAuth handshake with Shopify using your pre-registered credentials
Validates the connection to ensure everything is working
Updates merchant status from "Pre-Registered" to "Connected"
Sends webhook to notify you of successful connection
Begins catalog sync to make products available in your channel
You don't need to handle any technical OAuth details — Violet manages the entire process using the Client ID and Client Secret you provided during pre-registration.
Link Format
Your merchant-specific Violet Connect links follow this format:
The encoded pre-registration data automatically connects everything to your pre-registration in the Channel Dashboard.
Next steps:
Troubleshooting & FAQs — Common issues and solutions
Back to Pre-Registration — Set up more merchants
Last updated
Was this helpful?