Managing partner commissions and clawbacks

Learn how partner commissions work on Dub, and how to create manual commissions or clawbacks (negative commissions).

Marcus Farrell

Written by Marcus Farrell

This feature is only available for Business plans and above.

Where to find your program commissions?

When viewing your Partner Program navigation, click on the Commissions page, under the Insights group:

Commissions page within your dashboard

This opens up the commissions table view, where you can see a list of your historical commissions for your program:

Commissions page within your dashboard
Column      Data                 
Date      Commission date
Customer       The customer associated with the lead or sale  
Partner  Your partner
Type  The commission type (custom, click, lead, or sale)
Amount  The sale amount, or single count for custom, click, or lead rewards
CommissionThe amount the partner will receive
StatusCurrent status of the commission. Learn more about statuses.
Additional actionsActions to mark the commission as duplicate, fraud, or canceled

Commission statuses

When a commission is recorded on Dub, it goes through the following statuses:

  • Pending: This is the initial status for a commission. Depending on your program's holding period, commissions can stay in "pending" status anywhere from less than a day to 90 days.
  • Processed: When a commission has been added to a payout (after any applicable holding period), its status will change from "pending" to "processed".
  • Paid: When the payout containing the commission has been paid, the commission will be updated to "paid" status.

If needed, you can also update the status for a given commission accordingly:

  • Refunded: If the sale for the commission was refunded. This is usually automatically detected via our Stripe integration, or can also be manually set via the dashboard or the API.
  • Fraud: If a commission event was found to be fraudulent, you can mark them as "Fraud" via the dashboard or the API. This action cannot be undone.
  • Canceled: If a commission event was canceled/voided (e.g. in cases of self-referrals where commissions are not eligible for payout), you can mark them as "Canceled" via the dashboard or the API. This action cannot be undone.
  • Duplicate: If a commission event was found to be a duplicate, you can mark them as "Duplicate" via the dashboard or the API. This action cannot be undone.

Creating manual commissions

Occasionally, you might need to create a one-off or recurring commission to account for a missed commission or other reasons. On Dub, you can easily create those commissions via the dashboard, and they will be included in the next payout for that partner.

This can be accomplished by clicking Create commission from your Commissions page.

Create one-time commission

It can also be accomplished by clicking Create commission from an individual partner profile

Create one-time commission

One-time commissions

Manual one-time commissions are often used when you want to send a thank-you or bonus, fix a missed commission due to a clerical or tracking error, or create a payout that isn’t tied to a customer, referral link, or transaction.

Create one-time commission
InputDescription Required
Commission date Commission date - If no date is selected, it will auto-fill with the current date and time
Amount Commission amount 

Recurring sale commission

Manual sale commissions are recurring and based on your reward settings, so the partner commission is calculated automatically after entering the sale amount. Sale commissions also create a sale event under your analytics, and updates your revenue statistics.

Create sale commission
InputDescription Required
Referral link The referral link that the sale is attributed to
CustomerThe customer associated with the sale.
Sale dateThe date of the sale. If no date is selected, it will auto-fill with the current date and time
Sale amount The amount of the sale in USD.Required if not reusing existing events
Invoice IDThe invoice ID of the sale. Can be used to fetch the commission later via the API

Lead commission

Manual lead commissions are one-time and based on your reward settings, so the commission is automatically calculated.

Create one-time commission
InputDescription Required
Referral link The referral link that the lead is attributed to
CustomerThe customer associated with the lead.
Lead event dateThe date of the lead event. If no date is selected, it will auto-fill with the current date and time
Lead event nameThe name of the lead event.

Reusing existing conversion events

During the commission creation flow, you can choose between the following options:

  1. Use existing events: Create commissions from the customer's existing conversion events (e.g. if the lead/sale was tracked under a different link in your workspace, you can use this to "reassign" them to the correct partner).
  2. Create new events: Create new lead/sale events entirely.

If you choose Use existing events, the customer’s existing lead and sale events will appear in the sheet for your review.

Then, once you click Create commission, the events will be transferred to the selected partner and the old customer will be renamed with an (old) suffix:

Customer old suffix

Any previously created commissions for that partner will also have their eventId and invoiceId fields nullified as well (since we're reassigning them to the new commissions).

Creating a clawback

In the event an incorrect commission has been paid to a partner, you can create a clawback commission, which results in a negative commission for the partner and is subtracted from their next payout.

To create a clawback, click the More button next to Create commissions, then Create clawback.

Commissions dropdown

Fields required to create a clawback:

  • Partner: The partner receiving the clawback
  • Amount: The clawback amount
  • Clawback reason:
    • Order canceled
    • Fraud
    • Terms violation
    • Tracking error
    • Payment failed
    • Ineligible partner
    • Duplicate commission
    • Other

After the clawback is created, you'll see a negative commission in your table view:

Clawback created

The partner affected will see this reflected in their earnings view on their dashboard:

Clawback partner view

Did this answer your question?