> ## Documentation Index
> Fetch the complete documentation index at: https://dub.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Sale-based rewards
> Learn how to reward partners with a revenue share or flat fee for every sale they drive
Sale rewards are available on [Business plans and
above](https://dub.co/pricing).
A **sale-based reward** (pay-per-sale) pays partners when a customer they referred makes a purchase. It's the most common reward type on Dub, and the one most partners expect: they earn either a percentage of the sale (revenue share) or a fixed fee per sale.
Unlike [click](/help/article/click-rewards) and [lead](/help/article/lead-rewards) rewards, sale rewards can be **recurring**, so a partner keeps earning on every renewal for as long as you choose.
## How sale rewards work
Sale rewards are triggered by **sale events** on Dub. A sale event is created whenever:
* You track a sale via the [`/track/sale`](/docs/api-reference/track/sale) endpoint or one of our [SDKs](/docs/sdks/overview)
* A payment or invoice is paid via your [Stripe integration](/docs/integrations/stripe)
Each sale event creates a [commission](/help/article/partner-commissions) for the partner whose link the customer came from. Dub applies the sale reward in this order:
1. a [link-level](/help/article/partner-rewards#link-level-rewards) reward if one is set,
2. otherwise a [partner-level](/help/article/partner-rewards#partner-level-rewards) reward,
3. otherwise the partner's [group](/help/article/partner-groups) reward.
The commission amount is determined by that reward, plus any [conditions](#sale-reward-conditions) that match the sale.
If a sale is later refunded or disputed, Dub automatically creates a [clawback](/help/article/partner-commissions#creating-a-clawback) for the associated commission. See [handling refunds](/docs/conversions/sales/refunds).
## Creating a sale reward
In your [group rewards](https://app.dub.co/program/groups/default/rewards) tab, click **Create** next to the **Sale reward** type.
When the reward builder is open, set your amount per sale, and optionally set your [sale reward conditions](#sale-reward-conditions).
Once you've configured the reward, you'll see a [reward preview](/help/article/partner-rewards#reward-preview) and [quality score](/help/article/partner-rewards#reward-quality), and be asked to [confirm](/help/article/partner-rewards#confirm-reward-creation) before it goes live.
Dub generates the reward description partners see automatically, but you can customize how it's shown to partners by using the [customize the reward description](/help/article/partner-rewards#custom-reward-descriptions) by clicking the pencil button next to the reward.
You can also describe the reward in plain English using the [AI reward builder](/help/article/partner-rewards#using-the-ai-reward-builder), for example:
* "30% recurring for 12 months"
* "50% lifetime for customers who joined before Jan 2026, else \$100 one time"
* "\$500 if productId = 'prod\_xxx' (Pro Plan), else \$100 one time"
### Amount
Sale rewards support two payout models:
| Model | Description | Example |
| -------------- | ------------------------------------------------------------------ | ----------------- |
| **Percentage** | Partners receive a share of each sale's value (revenue share) | 30% of sale value |
| **Flat** | Partners receive a fixed fee for each sale, regardless of its size | \$50 per sale |
Percentage rewards are calculated on the sale amount Dub receives. For Stripe, that's the invoice or checkout total after any discounts, and for `/track/sale` it's the `amount` you pass.
### Duration
The duration controls how long a partner keeps earning on a given customer after the first sale:
| Duration | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| **One time** | The partner earns on the customer's first sale only. |
| **1 to 24 months** | The partner earns on every sale from that customer within the window (presets: 1, 3, 6, 12, 24 months, or a custom amount of months. |
| **Lifetime** | The partner earns on every sale from that customer, forever. |
## Sale reward conditions
Customizing reward conditions is only available on the [Advanced plan and
above](https://dub.co/pricing).
Conditions let you pay a different amount when a sale meets certain criteria. Click **Add condition** in the reward builder, and set the reward amount and duration for each condition block.
### Customer attributes
| Attribute | Description |
| --------------------------- | ---------------------------------------------------------------------------------- |
| **Country** | The customer's country, based on the location of the click that led to the signup. |
| **Subscription duration** | How many months the customer has been subscribed, counted from their first sale. |
| **Subscription start date** | The date of the customer's first sale. |
| **Signup date** | The date the customer was created on Dub (usually their lead event). |
### Partner attributes
| Attribute | Description |
| --------------------- | ------------------------------------------------------------------ |
| **Country** | The country on the partner's profile. |
| **Total clicks** | Total clicks the partner has driven. |
| **Total leads** | Total leads the partner has generated. |
| **Total conversions** | Total sale conversions the partner has generated. |
| **Total revenue** | Total sale amount the partner has driven (in USD). |
| **Total commissions** | Total commissions the partner has earned in your program (in USD). |
### Sale attributes
| Attribute | Description |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Product ID** | The product ID the sale is for. Use `Shown as` to modify how the reward shows to your partners. |
| **Amount** | The sale amount in USD. |
| **Type** | `new` for the customer's first sale, `recurring` for every sale after that. |
| **Metadata** | Any custom field attached to the sale via the `metadata`, or pulled from Stripe checkout session or invoice metadata. |
Learn more about [metadata conditions](/help/article/partner-rewards#metadata-conditions).
## Sale reward examples
### First-sale bonus
Pay a big rate on the first sale to reward customer acquisition, then a standard rate on renewals:
| Condition | Reward | Description |
| --------------------------------- | ----------------------------------------- | ----------------------------------- |
| If `Sale` `Type` `is` `new` | Then pay a `Percentage` of `80%` per sale | First-sale bonus for new customers |
| If `Sale` `Type` `is` `recurring` | Then pay a `Percentage` of `30%` per sale | Standard reward for recurring sales |
### Staggered reward durations
Tailor your reward amount by the customer's subscription duration, subscription start date, or signup date.
In this example, we're offering a 25% reward for the first 12 months and a 10% reward for all other sales:
There are 3 different conditions for staggered reward durations:
| Condition type | Description | Example |
| -------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------ |
| **Customer's subscription duration** | How long the customer has been subscribed for | 25% for the first 12 months, 10% for the rest of the customer's lifetime |
| **Customer's subscription start date** | The date the customer started their subscription | 25% if subscribed before Jan 1, 2026, else 10% |
| **Customer's signup date** | The date the customer signed up for your product | 25% if signed up before Jan 1, 2026, else 10% |
### Geo-specific
Tailor your reward amount by customer country. In this example, we're rewarding partners with a higher percentage for conversions from Canada and the United States:
| Condition | Reward | Description |
| --------------------------------------------------------------- | ----------------------------------------- | ---------------------------------------------------- |
| If `Customer` `Country` `is one of` `Canada, United States` | Then pay a `Percentage` of `40%` per sale | Higher reward for US and Canadian customers |
| If `Customer` `Country` `is not one of` `Canada, United States` | Then pay a `Percentage` of `30%` per sale | Lower reward for customers outside the US and Canada |
### Product spotlight
Tailor your reward amount by product. In this example, we're rewarding more when the sale is for the Gold Plan:
| Condition | Reward | Description |
| ------------------------------------------ | ----------------------------------------- | ------------------------------------- |
| If `Sale` `Product ID` `is` `prod_xxx` | Then pay a `Percentage` of `40%` per sale | Higher reward for `prod_xxx` sales |
| If `Sale` `Product ID` `is not` `prod_xxx` | Then pay a `Percentage` of `10%` per sale | Lower reward for non-`prod_xxx` sales |
You can also set what the partner sees as the product name by adding a `Shown
as` field to the reward.
For example, if you want to show the product as "Gold Plan" instead of the
actual product ID, you can set the `Shown as` to `Gold Plan`.
Where `Your product ID` is listed, you'll enter your product ID (the
screenshot uses an example product ID)
If you're manually tracking a sale event via our `/track/sale` endpoint, you
can pass along the product ID via the [metadata
prop](/docs/api-reference/track/sale#body-metadata-one-of-0)
(e.g. `metadata.productId = "prod_xxx"`).
If you're using our [Stripe
integration](/docs/integrations/stripe), the product ID will be the Stripe
product ID that the subscription is for (starts with `prod_xxx`). If a Stripe invoice contains multiple line
items (e.g. a base subscription plus an add-on), Dub
calculate the commission for each line item using the matching reward
rate. [See full example here](/docs/integrations/stripe#multiple-line-items-per-invoice).
### Sale amount modifiers
For creating tiered rewards based on the sale amount. In this example, we're giving our partners a higher reward if the sale amount is over a specific dollar amount:
| Condition | Reward | Description |
| ------------------------------------------------------- | ----------------------------------------- | ---------------------------------- |
| If `Sale` `Amount` `is greater than or equal to` `$100` | Then pay a `Percentage` of `60%` per sale | Higher reward for sales over \$100 |
| If `Sale` `Amount` `is less than or equal to` `$100` | Then pay a `Percentage` of `25%` per sale | Lower reward for sales under \$100 |
### Partner performance tiers
Tailor your reward amount by partner performance. In this example, we offer a 50% base reward and increase it to 60% based on how many conversions the partner has:
| Condition | Reward | Description |
| ----------------------------------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------ |
| If `Partner` `Total conversions` `is greater than or equal to` `200` | Then pay a `Percentage` of `60%` per sale | Higher reward for partners with more than 200 conversions |
| If `Partner` `Total revenue` `is greater than or equal to` `$10,000` | Then pay a `Percentage` of `60%` per sale | Higher reward for partners with more than \$10K in referral revenue |
| If `Partner` `Total commissions` `is greater than or equal to` `$1,000` | Then pay a `Percentage` of `60%` per sale | Higher reward for partners who have earned more than \$1K in commissions |
Want to move partners to a different partner group based on their performance
instead? [Learn more about group move
rules](/help/article/partner-groups#group-move-rules).
### Annual vs. monthly billing
Tailor your reward amount based on a [metadata condition](/help/article/partner-rewards#metadata-conditions). In this example, we're passing a `billingCycle` field on each sale (via the `metadata` prop on [`/track/sale`](/docs/api-reference/track/sale)) and rewarding partners more for driving annual plans over monthly plans:
| Condition | Reward | Description |
| --------------------------------------- | ----------------------------------------- | --------------------------------- |
| If `Sale` `billingCycle` `is` `annual` | Then pay a `Percentage` of `40%` per sale | Higher reward for annual plans |
| If `Sale` `billingCycle` `is` `monthly` | Then pay a `Percentage` of `20%` per sale | Standard reward for monthly plans |
### New vs. recurring sales
Tailor your reward amount based on whether the sale is the customer's first sale or a recurring sale. During reward creation, select `Sale` as the condition type and then choose `Type` as the condition field. This will allow you to differentiate between new and recurring sales.
In this example, we're rewarding partners with a 80% reward for the first sale while keeping the standard recurring commission for all other sales:
This is especially useful for subscription-based products, where you may want to offer a higher reward for the first sale to incentivize partners to acquire new customers, while offering a lower reward for recurring sales, while combining with other conditions.
| Condition | Reward | Description |
| --------------------------------- | ----------------------------------------- | ----------------------------------- |
| If `Sale` `Type` `is` `new` | Then pay a `Percentage` of `80%` per sale | First-sale bonus for new customers |
| If `Sale` `Type` `is` `recurring` | Then pay a `Percentage` of `30%` per sale | Standard reward for recurring sales |
## Updating a sale reward
When you change a group's sale reward, historical commissions aren't changed. The new configuration applies to future sales – including renewals from customers the partner referred before the change – only when no [link-level](/help/article/partner-rewards#link-level-rewards) or [partner-level](/help/article/partner-rewards#partner-level-rewards) override is configured. If you switch a group from one-time to recurring, previously referred customers' renewals become eligible for commission again.