Store Connection
Link your Shopify store to your ecomVance account to unlock all AI-powered features. This secure connection enables seamless credit management and access to 12+ AI tools.
Secure Connection: Your store is connected using unique API credentials with SHA-256 encryption. Credentials are automatically rotated on each reconnection for maximum security.
Prerequisites
Before connecting, ensure you have:
| Requirement | Status |
|---|---|
| ecomVance Shopify Plugin | Must be installed first |
| ecomVance Account | Create at app.ecomvance.ai or during connection |
| Store Admin Access | Owner or staff with app permissions |
Connection Methods
Method 1: From Shopify Plugin (Recommended)
Open ecomVance in Shopify
- Go to your Shopify Admin
- Navigate to Apps → ecomVance
- You’ll see the connection screen
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ 🤖 ecomVance │
│ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ Welcome to ecomVance! │ │
│ │ │ │
│ │ Connect your ecomVance account to start using AI tools. │ │
│ │ │ │
│ │ ┌────────────────────────────────────────────────────────────────┐│ │
│ │ │ ││ │
│ │ │ Your Store: my-store.myshopify.com ││ │
│ │ │ ││ │
│ │ │ ┌──────────────────────────────────────────────────────────┐ ││ │
│ │ │ │ │ ││ │
│ │ │ │ I have an ecomVance account │ ││ │
│ │ │ │ [Connect Existing Account] │ ││ │
│ │ │ │ │ ││ │
│ │ │ │ ───────────── OR ───────────── │ ││ │
│ │ │ │ │ ││ │
│ │ │ │ I'm new to ecomVance │ ││ │
│ │ │ │ [Create Free Account] │ ││ │
│ │ │ │ │ ││ │
│ │ │ └──────────────────────────────────────────────────────────┘ ││ │
│ │ │ ││ │
│ │ └────────────────────────────────────────────────────────────────┘│ │
│ │ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘Choose Your Path
Existing Account:
- Click Connect Existing Account
- You’ll be redirected to ecomVance login
- Enter your credentials
- Authorize the connection
New Account:
- Click Create Free Account
- You’ll be redirected to signup
- Fill in your details (email pre-filled from Shopify)
- Verify your email
- Authorize the connection
Authorize Connection
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ 🔐 Authorize Connection │
│ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ my-store.myshopify.com wants to connect to your │ │
│ │ ecomVance account. │ │
│ │ │ │
│ │ This will allow: │ │
│ │ │ │
│ │ ✅ Access to AI tools from Shopify │ │
│ │ ✅ Unified credit balance across platforms │ │
│ │ ✅ Real-time usage analytics │ │
│ │ ✅ Automatic trial activation (14 days, 100 credits/day) │ │
│ │ │ │
│ │ │ │
│ │ [Cancel] [Authorize] │ │
│ │ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘Connection Complete
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ ✅ Store Connected Successfully! │
│ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ Your store is now linked to your ecomVance account. │ │
│ │ │ │
│ │ Account: user@email.com │ │
│ │ Plan: Free Trial (14 days remaining) │ │
│ │ Daily Credits: 100 │ │
│ │ │ │
│ │ 🎉 You're ready to start using AI tools! │ │
│ │ │ │
│ │ [Start Using AI Tools →] │ │
│ │ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘Method 2: From ecomVance Dashboard
Login to ecomVance
- Go to app.ecomvance.ai
- Login to your account
- Navigate to Settings → Integrations
Connect Shopify Store
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ ⚙️ Settings → Integrations │
│ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ Shopify Integration │ │
│ │ │ │
│ │ ┌──────────────────────────────────────────────────────────────────┐ │ │
│ │ │ │ │ │
│ │ │ 🛍️ Connect a Shopify Store │ │ │
│ │ │ │ │ │
│ │ │ Store Domain: │ │ │
│ │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │
│ │ │ │ my-store.myshopify.com │ │ │ │
│ │ │ └────────────────────────────────────────────────────────────┘ │ │ │
│ │ │ │ │ │
│ │ │ [Connect Store] │ │ │
│ │ │ │ │ │
│ │ └──────────────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘Install Plugin on Shopify
After entering your domain, you’ll be redirected to Shopify to:
- Install the ecomVance app (if not already installed)
- Grant necessary permissions
- Complete the connection
What Happens During Connection
Behind the Scenes
Connection Process:
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ 1. Store Verification │
│ │ │
│ └── Verify shop_domain, shop_id, shop_email │
│ │
│ 2. User Lookup/Creation │
│ │ │
│ ├── Existing User ──► Link store to user account │
│ │ │
│ └── New User ──► Redirect to signup with pre-filled data │
│ │
│ 3. Credential Generation │
│ │ │
│ ├── API Key: ev_shop_xxxxxxxxxxxxx (unique per store) │
│ └── API Secret: evs_shop_xxxxx (shown once, SHA-256 hashed) │
│ │
│ 4. Trial Activation │
│ │ │
│ ├── 14-day trial period started │
│ ├── 100 credits/day allocated │
│ └── All tools unlocked │
│ │
│ 5. Response to Shopify Plugin │
│ │ │
│ └── Credentials + plan info returned securely │
│ │
└─────────────────────────────────────────────────────────────────────────────┘API Response (Technical Details)
For developers, here’s what the connection API returns:
{
"success": true,
"data": {
"store_id": "uuid-of-store",
"user_id": "uuid-of-user",
"api_key": "ev_shop_xxxxxxxxxxxxx",
"api_secret": "evs_shop_xxxxxxxxxxxxx",
"plan": "Trial",
"plan_credits": 100,
"package_credits": 0,
"total_credits": 100,
"trial_ends_at": "2025-02-06T12:00:00Z",
"is_new": true,
"credit_source": "unified_user_account"
}
}Verifying Connection
After connecting, verify everything is working:
In Shopify Plugin
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ 🤖 ecomVance user@email.com │
│ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ Store: my-store.myshopify.com Status: ✅ Connected │ │
│ │ │ │
│ │ ┌──────────────────────────────────────────────────────────────────┐ │ │
│ │ │ │ │ │
│ │ │ Plan: Free Trial Credits: 85/100 today │ │ │
│ │ │ Trial ends: Feb 6, 2025 Used today: 15 │ │ │
│ │ │ │ │ │
│ │ └──────────────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ Quick Actions: │ │
│ │ [🖼️ Remove Background] [✨ Enhance] [📝 Description] [More ▼] │ │
│ │ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘In ecomVance Dashboard
┌──────────────────────────────────────────────────────────────────────────────┐
│ │
│ ⚙️ Settings → Integrations │
│ │
│ ┌────────────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ Connected Shopify Stores │ │
│ │ │ │
│ │ ┌──────────────────────────────────────────────────────────────────┐ │ │
│ │ │ 🛍️ my-store.myshopify.com │ │ │
│ │ │ │ │ │
│ │ │ Status: ✅ Active │ │ │
│ │ │ Connected: Jan 23, 2025 │ │ │
│ │ │ Plan: Free Trial (14 days remaining) │ │ │
│ │ │ API Key: ev_shop_xxxxxx... │ │ │
│ │ │ │ │ │
│ │ │ [Regenerate Keys] [Disconnect] │ │ │
│ │ └──────────────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ [+ Connect Another Store] │ │
│ │ │ │
│ └────────────────────────────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────────┘Connection Checklist
| Check | Expected Result |
|---|---|
| Email displayed in plugin | ✅ Your ecomVance email shown |
| Credit balance visible | ✅ 100 (or remaining) credits displayed |
| Status shows “Connected” | ✅ Green checkmark |
| Tools are accessible | ✅ Can click tool buttons |
| Trial info displayed | ✅ Days remaining shown |
Unified Credit System
How Credits Work
Your credits are stored in your ecomVance account and shared across:
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ Unified Credit Balance │
│ │
│ ┌─────────────┐ │
│ │ │ │
│ │ 100 Credits │ │
│ │ │ │
│ └──────┬──────┘ │
│ │ │
│ ┌──────────────┼──────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ │ │ │ │ │ │
│ │ Shopify │ │ Web │ │ API │ │
│ │ Plugin │ │Dashboard │ │ Access │ │
│ │ │ │ │ │ │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ Use credits from any platform - balance syncs instantly │
│ │
└─────────────────────────────────────────────────────────────────────────────┘Credit Types
| Type | Reset Behavior | Source |
|---|---|---|
| Plan Credits | Daily (trial) or Monthly (paid) | Subscription |
| Package Credits | Never reset - carry forward | One-time purchase |
Deduction Priority
- Plan credits are used first
- Package credits are used when plan credits run out
- Credit restorations (for platform errors, at ecomVance’s discretion) go to package credits
Multiple Store Support
You can connect multiple Shopify stores to one ecomVance account:
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ Connected Stores │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 🛍️ store-one.myshopify.com ✅ Active [Manage] │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 🛍️ store-two.myshopify.com ✅ Active [Manage] │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 🛍️ store-three.myshopify.com ⏸️ Paused [Reactivate] │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ All stores share the same credit balance. │
│ [+ Connect Another Store] │
│ │
└─────────────────────────────────────────────────────────────────────────────┘💡
Shared Balance: All connected stores use the same credit balance. This is great for agencies or merchants with multiple brands.
Reconnecting a Store
If you need to reconnect (new credentials, reactivation, etc.):
From ecomVance Dashboard
- Go to Settings → Integrations
- Find your store
- Click Regenerate Keys
- Reinstall the Shopify plugin
From Shopify
- Uninstall ecomVance app
- Wait 30 seconds
- Reinstall from App Store
- Connect again
What Happens on Reconnect
Reconnection Process:
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ 1. Old credentials invalidated │
│ 2. New API key generated (ev_shop_newkey...) │
│ 3. New API secret generated and hashed │
│ 4. Store status updated to "active" │
│ 5. Credit balance preserved │
│ 6. Usage history maintained │
│ │
└─────────────────────────────────────────────────────────────────────────────┘Disconnecting a Store
To disconnect your store:
From ecomVance Dashboard
- Go to Settings → Integrations
- Find your store
- Click Disconnect
- Confirm the action
From Shopify
- Go to Apps → ecomVance
- Click Delete app
- Confirm uninstallation
What Happens on Disconnect
| Data | Action |
|---|---|
| Store credentials | Invalidated immediately |
| Generation history | Retained for 30 days |
| Credit balance | Preserved in your account |
| Subscription | Continues (if paid) |
⚠️
GDPR Note: 48 hours after uninstalling from Shopify, we receive a data deletion request. All store-specific data will be permanently deleted.
Troubleshooting Connection
”User Not Found” Error
Cause: No ecomVance account exists with your email.
Solution:
- Click “Create Free Account” instead
- Use the same email as your Shopify store
- Complete signup and return
”Invalid Credentials” Error
Cause: API keys have been regenerated or corrupted.
Solution:
- Go to ecomVance Dashboard → Settings → Integrations
- Click Regenerate Keys for your store
- Reinstall the Shopify plugin
”Store Already Connected” Error
Cause: This store is linked to a different ecomVance account.
Solution:
- Login to the original ecomVance account
- Disconnect the store
- Login to your desired account
- Reconnect the store
Connection Timeout
Cause: Network issues or server load.
Solution:
- Wait 30 seconds
- Try again
- Check your internet connection
- Contact support if persistent
Security Details
Credential Security
| Feature | Implementation |
|---|---|
| API Key Format | ev_shop_ + unique identifier |
| API Secret | SHA-256 hashed, never stored in plaintext |
| Transmission | HTTPS only, TLS 1.3 |
| Storage | Encrypted at rest |
| Rotation | Automatic on reconnection |
Authentication Flow
Request from Shopify Plugin
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ 1. API Key + Secret sent with request │
│ 2. Server hashes received secret │
│ 3. Compare with stored hash (timing-safe) │
│ 4. Verify store is active │
│ 5. Check credit balance │
│ 6. Process request if all checks pass │
│ │
└─────────────────────────────────────────────────────────────────────────────┘Next Steps
Need Help? Contact our support team at hello@ecomvance.ai for connection assistance.
Last updated on