GMV (Gross Merchandise Value) Calculation
GMV is the base merchandise value, excluding fees.
How it's calculated:
Sum of lineTotal.amount from transaction line items that meet all of:
includeFor contains both "customer" AND "provider"
reversal is false (not a reversal/refund)
Amount is positive
What it includes:
Base product/service value shared by both customer and provider
Items where both parties participate in the transaction
What it excludes:
Commission fees
Shipping costs
Extra fees
Customer-only or provider-only line items
Reversed/refunded items
Example:
If a transaction has:
Product price: £100 (shared by customer and provider)
Customer commission: £5
Provider commission: £10
Shipping: £15
GMV = £100 (only the product price)
Marketplace Revenue Calculation
Marketplace Revenue is the total commission revenue from the transaction.
How it's calculated:
Marketplace Revenue = Customer Commission + Provider Commission
Customer Commission:
Sum of line items where:
includeFor contains only "customer" (not "provider")
code or lineItemType contains "commission"
reversal is false
Amount is positive
Provider Commission:
Sum of line items where:
includeFor contains only "provider" (not "customer")
code or lineItemType contains "commission"
reversal is false
Amount is converted to absolute value (provider commissions may be negative)
What it includes:
Customer commission fees
Provider commission fees
What it excludes:
Shipping costs
Extra fees
Product/service value
Any non-commission fees
Reversed/refunded items
Example:
If a transaction has:
Product price: £100
Customer commission: £5
Provider commission: £10
Shipping: £15
Marketplace Revenue = £5 + £10 = £15 (only the commissions)
Key Differences
Metric | What It Represents | Includes | Excludes |
GMV | Base merchandise value | Product/service value shared by both parties | All fees, commissions, shipping |
Marketplace Revenue | Commission revenue | Customer + Provider commissions only | Product value, shipping, extras |
How They're Used
GMV is used for:
Percentage-based commission calculations (e.g., 5% of GMV)
Minimum transaction value thresholds (if minimumValueType is set to 'GMV')
Analytics and reporting on transaction volume
Marketplace Revenue is used for:
Minimum transaction value thresholds (if minimumValueType is set to 'REVENUE')
Understanding actual marketplace commission income
Revenue-based analytics