Overview
Welcome to Violet Merchant Help
Welcome to Violet's comprehensive merchant documentation center. Whether you're just getting started or need help managing your existing integration, you'll find everything you need to successfully connect your store and maximize your cross-platform selling potential.
Getting Started
New to Violet?
If you're here because a channel partner invited you to connect your store, you're in the right place. Violet makes it easy to expand your reach by selling through multiple channels while maintaining control of your inventory, pricing, and customer relationships.
Start Here: Understanding Violet Connect
Already Connected?
If you've already completed onboarding and need help managing your integration, jump straight to:
Platform Integration Guides
Choose your e-commerce platform to get started with a step-by-step integration guide:
Popular Platforms (5-10 minutes setup)
Enterprise Platforms (15-30 minutes setup)
Additional Supported Platforms
Prestashop - API key generation and webhook setup
Swell - Store API configuration
Spree - OAuth application setup
Vendo - API credentials and webhook configuration
Ecwid - App installation and token generation
Wix - Business Solutions integration
Squarespace - Commerce API setup
Note: Each platform guide includes platform-specific requirements, step-by-step setup instructions, and troubleshooting tips.
Violet Connect Onboarding
Violet Connect is our streamlined merchant onboarding process that walks you through connecting your store in just a few minutes.
What You'll Need
Access to your e-commerce platform's admin dashboard
Administrator permissions to create API credentials
Email address for account creation
Banking information for payout setup (if using Violet Payments)
Onboarding Steps
Platform Selection - Choose your e-commerce platform
Store URL Entry - Provide your store's URL
Credential Generation - Follow platform-specific guide to create API credentials
Credential Input - Enter credentials in Violet Connect
Payout Setup - Connect your bank account via Stripe (if applicable)
Commission Rate - Set your agreed-upon commission rate
Completion - Get redirected back to your channel partner
After Onboarding
Once connected, you'll receive an email with:
Login credentials for your Merchant Dashboard
Summary of your connection settings
Next steps for managing your integration
Merchant Dashboard
Your Merchant Dashboard is your central hub for managing all aspects of your Violet integration.
Access: merchant.violet.io
Dashboard Sections
Overview
View connected store information
See all connected channels
Manage commission rates by channel
Monitor connection health
Orders (Bags)
View all orders placed through Violet
Track order status and fulfillment
Filter by channel, date, or status
Export order data
Catalog (Offers)
View all synced products
Publish/unpublish products by channel
Filter by availability, status, and tags
Manage product visibility
Payouts
Review payout history and status
Track distributions across orders
Manage payout account settings
View commission earnings by channel
Communication
Messages: Direct communication with channels
Notifications: System alerts and updates
Commission History: Track rate changes over time
Order Management
Order Lifecycle
Order Placement - Customer places order through channel
Order Sync - Order appears in your e-commerce platform
Fulfillment - You fulfill the order as normal
Status Updates - Violet tracks fulfillment status
Payout - Commission is calculated and paid out
Key Considerations by Platform
Shopify
When canceling orders, always select "Refund Payments NOW"
Inventory syncs from all locations by default
Currency conversion uses real-time rates unless presentment currencies are configured
BigCommerce
Refunds show as "offline" - this is expected behavior
Use Coupon Codes (not Promotions) for discount integration
Multi-currency pricing supported through contextual pricing
Salesforce Commerce Cloud
Orders require special customer group (VIOLET_API)
Payment method configuration needed (VIOLET_API)
Refund notifications may require engineering integration
Troubleshooting
Common Connection Issues
"Store URL Invalid" Error
Shopify: Check for multiple domains in Settings → Domains, use the primary domain
All Platforms: Ensure URL includes
https://protocolVerification: URL should match what appears in your admin dashboard
Credential Validation Failures
Double-check for copy/paste errors and extra spaces
Ensure all required scopes/permissions are enabled
Verify credentials haven't expired or been regenerated
Check that API quotas haven't been exceeded
Missing Shipping Rates
Configure shipping zones for all target markets
Ensure products have weight/dimensions configured
Verify shipping methods are enabled for your regions
Check for location-based shipping restrictions
Platform-Specific Issues
Shopify
Minimum Plan: Requires Shopify Basic or higher
API Notices: Ignore Shopify API deprecation notices - Violet handles updates
Inventory Sync: Contact support if you need location-specific inventory filtering
BigCommerce
Offline Refunds: Expected behavior for Violet orders
Coupon Issues: Use Coupon Codes, not Promotions
Currency: Enable presentment currencies for multi-currency support
WooCommerce
Plugin Issues: Ensure WordPress/WooCommerce versions are current
Hosting: Verify hosting provider allows external API connections
Permissions: Check file permissions if plugin installation fails
Advanced Features
Multi-Currency Support
Default: Real-time currency conversion
Enhanced: Presentment currency pricing (requires setup)
Configuration: Contact your channel partner to enable
Inventory Management
Single Location: Automatic inventory sync
Multiple Locations: Combined inventory by default, filtering available
Real-time Updates: Inventory changes sync automatically
Commission Management
Flexible Rates: Set different rates per channel
Rate Changes: Update anytime through dashboard
History Tracking: Full audit trail of rate changes
Locking: Channels can lock rates via API if pre-negotiated
Getting Help
Self-Service Resources
Platform Guides: Step-by-step integration instructions
Dashboard Guide: Complete merchant dashboard walkthrough
API Documentation: Technical reference for developers
FAQ Section: Answers to common questions
Direct Support
Channel Partner: Your primary point of contact for business questions, technical issues and platform-specific help
Merchant Dashboard: Use Messages tab to communicate with channels
Documentation: AI-powered search (Ctrl/Cmd + K)
Emergency Issues
For urgent technical issues affecting order processing:
Contact your channel partner immediately
Check Violet status page for system-wide issues
Use Merchant Dashboard to temporarily unpublish affected products
Monitor order queue for processing delays
Next Steps
If You're Just Getting Started
Choose your platform from the integration guides above
Follow the step-by-step guide for your platform
Complete Violet Connect onboarding with your credentials
Test your integration with a sample order
Explore your Merchant Dashboard to familiarize yourself with the tools
If You're Already Connected
Bookmark your Merchant Dashboard for easy access
Review your commission rates across all channels
Set up order notifications to stay informed
Explore catalog management to optimize product visibility
Ready to Scale
Connect additional channels through the same process
Optimize your product data for better discoverability
Monitor performance metrics in your dashboard
Consider advanced features like presentment currencies
This documentation is continuously updated. For the latest information and new platform integrations, check back regularly or contact your channel partner.
Last updated
Was this helpful?