Commission Rates
The Commission Rate is the percentage of a product’s subtotal that a Channel receives from a Merchant when an item is sold. Violet facilitates the transfer of this commission at the time of sale, but does not dictate or manage the commercial agreement between the Channel and Merchant.
Each Merchant can define a separate commission rate per Channel during onboarding or from their Merchant Dashboard. This rate can be set between 0% and 100%, and is exclusive to that Channel-Merchant pairing.
Channels can also set or lock commission rates programmatically via API or manually through the Channel Dashboard. See the Commission Rate Management section for more details.
How Commission is Calculated
Commission is applied only to the subtotal—not tax, shipping, or other charges.
Calculation Breakdown:
- Commission Base:
Subtotal
- Commission Amount:
Subtotal × Commission Rate
- Merchant Payout:
Subtotal + Shipping + Tax - Commission
- Channel Net Distribution Amount:
Commission - Stripe Fee
Payment provider processing fees are always deducted from the Channel’s share, not the Merchant’s payout.
The table below highlights which components are included in the commission calculation and how they are distributed:
Component | Included in Commission | Recipient (in Distribution Amount) | Notes |
---|---|---|---|
Subtotal | ✅ Yes | Merchant (net of commission) | Commission is only applied here |
Tax | ❌ No | Varies (Merchant or Channel) | Depends on tax remitter configuration |
Shipping | ❌ No | Merchant | Always passed through in full |
Stripe Fees | ❌ No | Deducted from Channel | Based on total order value, always subtracted from Channel commission |
For a deeper understanding of how funds are split between merchants, channels, and fees, visit our the Distributions docs.
Example Calculations
Refunds and Chargebacks
Refunds
When a refund is initiated (full or partial):
- Commissions are reversed proportionally based on the refunded subtotal.
- To ensure accurate commission reversals, merchants must correctly specify the SKU amount, shipping amount, and tax amount when initiating the refund from their ecommerce platform.
- Stripe fees are refunded when applicable and automatically returned to the channel.
Commission Rate Management
Violet supports flexible commission rate management across the Channel–Merchant relationship. Rates can be set during onboarding and updated anytime via dashboard or API.
Channel-Controlled Rates
Channels can override or lock commission rates at the Merchant level based on the Channel’s business model or agreements with Merchants. This allows Channels to maintain control over commission structures while still providing Merchants the flexibility to set their own rates:
Via Dashboard
- Go to the Channel Dashboard
- Select a Merchant from the list
- Click into the “Commission Rate” field to edit
- Toggle the “Lock Rate” setting if you want to prevent merchant overrides
Via API
Use the Set Merchant/Channel Commission Rate
endpoint to:
- Set or update the commission rate
- Pass the
lock
parameter to restrict merchant changes
Merchant-Controlled Rates
Merchants can define or update the commission rate for each Channel they’re connected to:
- Go to the Merchant Dashboard
- Locate the relevant Channel under “Connected Channels”
- Click the current rate to edit
- Enter the new percentage and confirm
Each Channel relationship can have a unique commission rate. Updates apply immediately to future orders.