> For the complete documentation index, see [llms.txt](https://docs.violet.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.violet.io/prism/payments/payouts/commission-base.md).

# Commission Base: Tax, Duty and Discounts

Exactly which part of an order Violet charges commission on, how tax is taken out of tax-inclusive prices using a retailer's tax profile, and how duty and discounts are treated, on the sale and on ref

Commission is charged on goods only. Shipping, tax and duty are never part of it, and discounts come off before it is calculated. This page sets out how Violet arrives at that goods figure, the **commission base**, for every order, including retailers whose prices already include tax.

You do not send the commission base. Violet works it out from the order you submit and from settings Violet holds for each retailer.

## The Calculation

```
goods            = sub_total − discount_total
commission_base  = goods − tax_inside_goods − transaction_fee (Net Receipts only)
commission       = commission_base × commission_rate
```

* `tax_inside_goods` is zero unless the retailer prices its goods tax-inclusive. See [Tax-inclusive prices](#tax-inclusive-prices).
* `transaction_fee` applies only to a retailer on [Net Receipts](https://docs.violet.io/prism/payments/payouts/net-receipts.md) whose settings deduct the fee before commission. Tax comes off first, then the fee.
* Commission is rounded half-up to the nearest minor unit (cent, penny). A base of zero or less gives no commission.
* The same base is used whatever the retailer's [return policy](https://docs.violet.io/prism/payments/payouts/return-commission-policy.md), so `REVERSE`, `RETAIN` and Net Receipts retailers all start from the same figure.

| Order component                 | In the commission base?                        | Notes                                                                                                                                                   |
| ------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Goods (`sub_total`)             | Yes                                            | Net of tax for tax-inclusive retailers.                                                                                                                 |
| Discounts (`discount_total`)    | Taken off first                                | Commission is charged on what the shopper paid for the goods.                                                                                           |
| Shipping                        | No                                             | Passed to the retailer in full.                                                                                                                         |
| Tax reported as its own amount  | No                                             | Paid to whoever remits tax for the order. See [Tax Remitter Settings](https://docs.violet.io/prism/payments/payment-settings/tax-remitter-settings.md). |
| Tax inside tax-inclusive prices | No, once a tax profile is in force             | See below.                                                                                                                                              |
| Duty reported as its own amount | No                                             | Paid to the retailer with its payout.                                                                                                                   |
| Duty inside product prices      | Yes                                            | No per-retailer duty rate exists today. See [Duty](#duty).                                                                                              |
| Channel transaction fee         | Only for Net Receipts retailers that deduct it | See [Net Receipts](https://docs.violet.io/prism/payments/payouts/net-receipts.md).                                                                      |

## Tax-Inclusive Prices

Where tax is reported separately on the order, as on most US orders, it is already outside the goods price and there is nothing to remove.

Many retailers outside the US price their goods with VAT or GST included. For those retailers the goods price contains tax, and charging commission on it would inflate the commission. Violet removes the tax using the retailer's **tax profile**.

A tax profile records, for the retailer's home country:

* whether its prices **include** tax, **exclude** tax, or are **undeclared**;
* the standard rate to use when an order shows no tax of its own;
* the date and time the profile takes effect.

Violet uses the profile rather than tax flags on individual orders. Those flags are not reliable across ecommerce platforms: the same retailer's orders can arrive flagged one way on one day and the other way the next.

### What Violet does with each profile

| Retailer's profile                                    | What happens to the goods price                                                                | Example at 15% commission                                                |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Prices include tax**, and the order reports its tax | The reported tax is removed.                                                                   | Goods £120.00 with £20.00 VAT reported. Base £100.00, commission £15.00. |
| **Prices include tax**, and the order reports no tax  | Tax is removed at the profile's rate: `goods ÷ (1 + rate)`, rounded half-up to the minor unit. | Goods £120.00 at 20%. Base £100.00, commission £15.00.                   |
| **Prices exclude tax**                                | Nothing is removed.                                                                            | Goods £100.00. Base £100.00, commission £15.00.                          |
| **Undeclared**, or no profile                         | Nothing is removed. Commission is on the goods price as submitted.                             | Goods £120.00. Base £120.00, commission £18.00.                          |

An undeclared retailer is never stripped at a guessed rate. Until a retailer has a profile in force, nothing changes for it.

### Rules that hold for every profile

* **Home country only.** A profile applies to all of the retailer's orders, wherever they ship. A retailer that charges VAT-inclusive prices at home but sells tax-free for export cannot yet have a separate profile per destination. Tell Violet before such a retailer's profile is switched on.
* **Forward-dated, never backdated.** A profile takes effect at a set date and time in the future. Orders placed before that keep the base they were placed under.
* **The profile in force when the order was placed applies,** not the one in force when the bag is split or refunded.
* **One standard rate.** A flat rate suits a catalogue where every item carries the standard rate, such as adult clothing. It is wrong for items taxed at a reduced or zero rate, such as children's clothing in the UK. If a tax-inclusive retailer sells such ranges, tell Violet so its profile can be adjusted.

### Who manages tax profiles

Violet sets and changes tax profiles. Channels cannot read or change them through the API. To declare a retailer's basis, change a rate, or ask when a profile takes effect, [contact Violet support](https://docs.violet.io/help/support-request.md) with the retailer and the basis you want applied. Violet confirms the date it takes effect.

## Duty

Duty is treated like tax: it is not part of what the retailer sold, so it stays out of the commission base. How far Violet can do that depends on where the duty sits on the order.

| Where the duty is                                                                                                                                                                                                | Effect on commission                                                                                                                                                       |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Reported as its own amount**, through `type: "DUTY"` entries in each SKU's `rates` on [Direct Order Submission](https://docs.violet.io/prism/checkout-guides/guides/direct-order-submission.md) or at checkout | Excluded, on the sale and on refunds. This is the only exact route. See [Cross-Border Duties](https://docs.violet.io/prism/checkout-guides/guides/cross-border-duties.md). |
| **Built into the shipping charge**                                                                                                                                                                               | No effect. Shipping is outside the commission base. Violet cannot separate the duty from shipping unless it is reported on its own.                                        |
| **Built into the product price**                                                                                                                                                                                 | Stays in the commission base. Violet does not currently support a duty rate per retailer.                                                                                  |

If a retailer can report duty per order, have it do so. That keeps duty out of the base exactly.

{% hint style="info" %}
For a retailer whose duty-inclusive prices also include VAT, the tax profile still removes VAT correctly, because import VAT is charged on the duty-inclusive value. What remains after the VAT comes out is goods plus duty.
{% endhint %}

Duty reported on an order is paid to the retailer with its payout.

## Refunds Use the Same Base

The commission a refund reverses (under `REVERSE`) or keeps (under `RETAIN`) is worked out on the same basis the sale used, so the two always agree.

```
goods_refunded = refund_amount − shipping − tax − duty
```

* **Tax-inclusive sale.** A refund removes tax in the same proportion as the sale did. Returning £60.00 of goods from the £120.00 sale above gives a refund base of £50.00, and £7.50 of commission.
* **Duty on refunds.** Duty the refund states is removed. If the refund does not state its duty, Violet works out the duty share of the refund from the order.
* **Never more than the sale.** The commission on each refund is capped at what the sale charged. Under `RETAIN` it is also capped at what earlier refunds of the bag have left.

## Worked Example

<details>

<summary>Tax-inclusive retailer on Net Receipts, with a discount</summary>

**Retailer:** prices include 20% VAT. Net Receipts settings deduct the fee before commission. Commission rate 15%.

**Order:** goods £130.00, discount £10.00, shipping £5.00, no tax reported on the order. Your app supplies a transaction fee of £3.00.

1. Goods = £130.00 − £10.00 = £120.00
2. Tax inside goods = £120.00 − (£120.00 ÷ 1.20) = £20.00, so the base is £100.00
3. Fee deducted: £100.00 − £3.00 = £97.00
4. Commission = £97.00 × 15% = £14.55

Shipping (£5.00) is outside the base and goes to the retailer.

</details>

## Related

* [Commission Rates](https://docs.violet.io/prism/payments/payouts/commission-rates.md)
* [Return Commission Policy](https://docs.violet.io/prism/payments/payouts/return-commission-policy.md)
* [Net Receipts](https://docs.violet.io/prism/payments/payouts/net-receipts.md)
* [Tax Remitter Settings](https://docs.violet.io/prism/payments/payment-settings/tax-remitter-settings.md)
* [Cross-Border Duties](https://docs.violet.io/prism/checkout-guides/guides/cross-border-duties.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.violet.io/prism/payments/payouts/commission-base.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
