> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shopjar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Commissions & tiers

> Commission rules, the commission ledger, and automatic revocation on refunds.

## Commission rules

Create rules under **Affiliate → Program → Commission → Create
commission**. Each rule has a **Title**, **Status** (Active / Draft),
and a commission type:

* **Percentage commission** — e.g. 10% of the affiliate sale
* **Fixed commission** — e.g. \$5 for each affiliate sale

**Conditions (optional)** let you build tiers and special cases, with
Match All / Match Any logic:

* Number of referrals · Referral sales amount by the affiliate
* **On every X sales** (e.g. a bonus on every 10th sale) · **On every X
  sale revenue** (e.g. every \$1,000 of revenue)
* Usage Limit for an Affiliate
* Referred-customer conditions: order value, total spent, selected
  products/variants, email domain

**Include / Exclude members** limits a rule to specific affiliates —
the mechanism behind VIP rates. **Active dates** schedule a rule, and
**Manage priority** decides which rule wins when several match.

<Tip>
  Build a ladder with member targeting: a base 10% rule for everyone,
  plus a 15% rule that includes only your proven top performers.
  Affiliates have a reason to push for the next tier.
</Tip>

## The commission ledger

**Affiliate → Sales & Commissions → Commissions** lists every earned
commission with its status:

| Status    | Meaning                                            |
| --------- | -------------------------------------------------- |
| Pending   | Earned, awaiting approval (per your approval mode) |
| Approved  | Counted in the affiliate's payable balance         |
| Claimed   | Converted by the affiliate (coupon / store credit) |
| Cancelled | Revoked — manually or by auto-revoke               |
| Fraud     | Marked fraudulent; excluded from balances          |

Select rows for bulk **Approve**, **Cancel**, or **Fraud** actions.

**Approval mode** (Affiliate → Settings → Reward Approval): **Auto**,
**Manual**, or **Auto approve after delay** (1–80 days).

## Auto-revoke on refunds

Under **Affiliate → Settings → Revoke Commission**, pick which order
statuses count as unsuccessful — **Canceled**, **Refunded**,
**Partially Refunded**, **Voided** — and choose **Yes, cancel
immediately** to revoke the commission automatically when an
affiliate-attributed order turns into one of them.

<Tip>
  Pair auto-revoke with **Auto approve after delay** set past your
  return window. Together they make refund abuse structurally
  impossible instead of something you police manually.
</Tip>

## Use cases & examples

<AccordionGroup>
  <Accordion title="Simple flat commission" icon="percent" description="10% of every affiliate sale — one rule, done.">
    One Percentage commission rule at 10, auto-approval with a 30-day
    delay, auto-revoke on refunds. A complete, safe program in three
    settings.
  </Accordion>

  <Accordion title="Volume bonus" icon="chart-line" description="An extra $50 on every 10th sale.">
    Add a Fixed commission rule of 50 with condition **On every X
    sales → 10**. It stacks motivation on top of the base rate.
  </Accordion>

  <Accordion title="Product-launch push" icon="rocket" description="Double commission on the new collection, this month only.">
    A 20% rule with condition on **selected products** and **Active
    dates** covering launch month, priority above the base rule.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="A sale wasn't attributed to the affiliate">
    Attribution needs the customer to arrive via the affiliate link or
    use their coupon. Check the **Sales** report; if the order used
    neither, no commission is created. Also check the rule's
    conditions and Include/Exclude member targeting.
  </Accordion>

  <Accordion title="A commission stayed Pending forever">
    Your approval mode is **Manual** — approve it in the ledger, or
    switch to **Auto approve after delay**.
  </Accordion>

  <Accordion title="A refunded order still paid commission">
    Check **Revoke Commission** includes the Refunded status and is
    set to **Yes, cancel immediately** — and note revocation can't
    claw back money already paid out; the delay-based approval
    prevents that case.
  </Accordion>
</AccordionGroup>

## Need help?

<CardGroup cols={3}>
  <Card title="Book a call" icon="calendar-days" href="https://cal.com/yukoteam/shopjar">
    Schedule a free call with our team for personal setup assistance.
  </Card>

  <Card title="Contact support" icon="comments" href="#crisp-chat">
    Chat with us directly — we're happy to help with any question.
  </Card>

  <Card title="Install Shopjar" icon="download" href="https://apps.shopify.com/referral-and-affiliates">
    Get [Shopjar Referral & Affiliate Marketing](https://apps.shopify.com/referral-and-affiliates) from the Shopify App Store.
  </Card>
</CardGroup>
