Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 20 additions & 17 deletions content/docs/brand/billing/overdue-policy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@
title: Overdue Invoices & Program Pause Policy
description: How Affitor handles unpaid commission invoices, when programs pause, and how to resume.
kind: reference
last_updated: 2026-09-24
last_updated: 2026-11-11
---

When a commission invoice is not paid by its due date, Affitor pauses the program until the balance clears. Tracking links keep working, partner data is preserved, and the program returns to active automatically once the overdue invoice is marked paid.
When a commission invoice is not paid by its due date and overdue pausing is on, as it is by default, Affitor pauses the program until the balance clears. While the program is paused, Affitor stops recording new clicks on its partner links. Eligible conversions from earlier recorded clicks can still count. Existing partner data is preserved. A program paused by the overdue check resumes automatically once none of its invoices remains Open or Overdue.

<PageMeta
items={[
Expand All @@ -22,7 +22,7 @@ When a commission invoice is not paid by its due date, Affitor pauses the progra
<FlowStep>Invoice issued Mon 09:00 UTC</FlowStep>
<FlowStep>Pay within 7 days → **paid:** Status: paid · **past due:** Status: overdue</FlowStep>
<FlowStep>Program paused</FlowStep>
<FlowStep>Mark invoice paid</FlowStep>
<FlowStep>No Open or Overdue invoices remain</FlowStep>
<FlowStep>Program auto-resumed</FlowStep>
</Flow>

Expand All @@ -32,42 +32,45 @@ When a commission invoice is not paid by its due date, Affitor pauses the progra
| **Invoice minimum** | Each Monday | If the approved commissions add up to less than the invoice minimum (currently $10), no invoice is issued that week. They carry forward and appear on a later invoice |
| **Net terms** | 7 days from issue date | The default. Talk to your account contact if you need different terms |
| **Overdue check** | Daily at 10:00 UTC | Invoices past their due date are marked overdue |
| **Program paused** | Same overdue run | The program enters a paused state; an email is sent to the workspace owner |
| **Auto-resume** | When the invoice is marked paid | The program returns to active on its own; you do not need to reactivate it. A wire transfer is marked paid by Affitor's billing team after they match it to the invoice |
| **Program paused** | Same overdue run | If overdue pausing is enabled, the program enters a paused state; an email is sent to the workspace owner |
| **Auto-resume** | When no Open or Overdue invoices remain | A program paused by the overdue check resumes automatically once none of its invoices remains **Open** or **Overdue**. An invoice leaves that set when it is paid or voided, so pay any newer invoice along with the overdue one. You do not need to reactivate it. A wire transfer is marked paid by Affitor's billing team after they match it to the invoice |

---

## When a program is paused

Pause is triggered automatically the first time a commission invoice passes its due date.
If overdue pausing is enabled, the daily overdue check pauses an active program when an unpaid invoice passes its due date.

### What changes while paused

- **Program status** flips to **Paused** in your dashboard and in partner-facing views.
- **Marketplace visibility** — paused programs are hidden from public partner discovery. Existing partners keep their dashboard access.
- **Program status** shows **Paused** in your dashboard, and the top of **Billing** says what resumes it. Partners in the program see **Paused** on its page in their dashboard.
- **Clicks** are not recorded. A visit through a partner link creates no click: the click call answers `410` with `link_disabled` ("Referral link is inactive"). See [Track Click](/docs/api-reference/track-click).
- **Marketplace visibility:** paused programs are hidden from public partner discovery. Existing partners keep their dashboard access.
- **Audit log** records the transition with a reference to the originating invoice.

### What does not change while paused

- **Existing tracking links** continue to resolve. Affitor never breaks partner URLs while you resolve billing.
- **Click, lead, and sale events** continue to be recorded. Sales attributed while paused still create commissions and platform fees exactly as when the program is active, and they appear on your next invoice. Pausing does not stop charges from accruing.
- **Partner data** — referrals, audience, and historic commissions are preserved in full.
- **Partner links** are not deleted or changed. They record clicks again as soon as the program is active.
- **Lead and sale events:** leads and sales linked to earlier recorded clicks remain subject to the usual attribution rules. Eligible commissions and applicable platform fees go through the usual weekly invoice process.
- **Partner data:** referrals, audience, and historic commissions are preserved in full.
- **Stripe Connect and customer-facing checkout** continue to work. Pause is a billing state, not a checkout state.

> Pause is a billing signal, not a tracking kill switch. Your customers are unaffected. Partners see the program as paused inside their dashboard and stop receiving new applications.
> Pausing stops new clicks from being recorded. Eligible conversions from earlier clicks can still count. New partners cannot find the program or apply to it in the marketplace until it resumes.

---

## How to resume

A paused program returns to active automatically when the overdue invoice is marked paid. You do not need to reactivate it yourself. For a wire transfer, the invoice is marked paid once Affitor's billing team has matched your payment to it.
A program paused by the overdue check resumes automatically once none of its invoices remains Open or Overdue. An invoice leaves that set when it is paid or voided, so pay any newer invoice along with the overdue one. You do not need to reactivate it yourself. For a wire transfer, the invoice is marked paid once Affitor's billing team has matched your payment to it.

A pause that the overdue check did not make, for example one set by Affitor for another reason, is not lifted by paying an invoice.

```mermaid
sequenceDiagram
Advertiser->>Affitor: Wire transfer arrives
Affitor->>Affitor: Billing team matches payment to invoice
Affitor->>Invoice: status = paid
Invoice->>Program: status = active
Invoice->>Program: status = active (no open invoice left)
Affitor->>Audit: program_unpaused entry
```

Expand All @@ -79,11 +82,11 @@ sequenceDiagram
Affitor's billing team matches the transfer to your invoice and marks it paid.
</FlowCard>
<FlowCard step="3" title="Your program returns to active">
Marking the invoice paid resumes the program, and the audit log records the unpause with the invoice number. You don't need to reactivate anything.
When no other invoice of the program is still Open or Overdue, marking this one paid resumes a program the overdue check paused, and the audit log records the unpause with the invoice number. You don't need to reactivate anything.
</FlowCard>
</FlowGrid>

If you've paid and the program is still paused a business day later, contact billing — the most common cause is a missing invoice number in the transfer reference.
If you've paid and the program is still paused a business day later, contact billing. The most common cause is a missing invoice number in the transfer reference.

---

Expand All @@ -106,7 +109,7 @@ Affitor bills through Wise wire transfers. Each invoice page shows the destinati

<TaskCardGrid>
<TaskCard title="Pay within the 7-day window" href="#how-to-pay-an-invoice">
Check the Billing tab after each Monday's invoice run. A new-invoice email is not sent on every account, so don't wait for an email — and don't wait for the overdue email.
Check the Billing tab after each Monday's invoice run. A new-invoice email is not sent on every account, so don't wait for an email, and don't wait for the overdue email.
</TaskCard>
<TaskCard title="Allowlist noreply@affitor.com and billing@affitor.com" href="mailto:billing@affitor.com">
Billing emails are sent from noreply@affitor.com with billing@affitor.com as the reply-to address. Add both to your AP allowlist so invoice and overdue emails reach the right inbox.
Expand Down
16 changes: 4 additions & 12 deletions content/docs/brand/quickstart/commission-approval-cash-flow.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Commission Approval & Cash Flow
description: Understand how attributed sales move into commissions, billing, and payout workflow.
kind: concept
last_updated: 2026-10-24
last_updated: 2026-11-11
---

This page traces the journey from an attributed sale through the commission hold, billing, and partner payout.
Expand All @@ -16,14 +16,6 @@ This page traces the journey from an attributed sale through the commission hold
]}
/>

## Payment integration method

| Method | Checkout ownership | How it works |
|--------|--------------------|--------------|
| **Invoice billing** | Your checkout | You collect customer payment, Affitor attributes conversions and bills through its invoice workflow |

---

## Invoice billing

**Step by step:**
Expand Down Expand Up @@ -114,9 +106,9 @@ The program's hold period, set under **Commission** in [program settings](/docs/

What happens depends on where the commission is when the refund arrives:

- **Pending** — nothing reaches the partner's balance. A full refund marks the commission **Reversed**, a partial one **Refunded**.
- **Approved or invoiced** — the refunded share is taken back from the partner's balance: all of the commission for a full refund, and the same fraction of it for a partial refund. The balance can go negative; the partner sees it as **Balance owed**, recovered from their next commissions.
- **Already collected** — Affitor deducts it from the partner's balance, which can go negative, and sends you a notification: reconciling with the partner is a manual step.
- **Pending:** nothing reaches the partner's balance. A full refund marks the commission **Reversed**, a partial one **Refunded**.
- **Approved or invoiced:** the refunded share is taken back from the partner's balance: all of the commission for a full refund, and the same fraction of it for a partial refund. The balance can go negative; the partner sees it as **Balance owed**, recovered from their next commissions.
- **Already collected:** Affitor deducts it from the partner's balance, which can go negative, and sends you a notification: reconciling with the partner is a manual step.

Platform fees already billed are not refunded. A refund lowers the revenue total that counts toward your program's $10,000 fee-free tier by the refunded amount, never by more than that sale added. See [Track refund](/docs/api-reference/track-refund) for the API details.

Expand Down
33 changes: 7 additions & 26 deletions content/docs/brand/quickstart/define-commission.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Define Commission
description: "Set commission rates and durations for your affiliate program per partner group, and see how a commission is calculated from a sale."
kind: concept
last_updated: 2026-11-07
last_updated: 2026-11-11
---

Commission determines what partners earn when they drive results. Configure the right type and duration to attract quality partners and align incentives with your business model.
Expand All @@ -11,15 +11,15 @@ Commission determines what partners earn when they drive results. Configure the

## Commission Basics

![Partner Groups — each group carries its own commission rate](/docs/brand/groups.png)
![Partner Groups: each group carries its own commission rate](/docs/brand/groups.png)

Commission is set per **partner group**: every partner belongs to a group (Default, unless you assign another), and the group's policy decides what they earn. That's how you run VIP tiers next to a standard rate without per-partner bookkeeping.

Every commission has two components:

| Component | Description |
|-----------|-------------|
| **Rate** | How much partners earn (percentage or fixed amount) |
| **Rate** | How much partners earn, as a percentage of each sale |
| **Duration** | How long partners earn from a referred customer |

---
Expand All @@ -34,31 +34,12 @@ Partners earn a percentage of each sale from customers they refer.

Revenue Share is the default and recommended type for SaaS products.

### CPC (Cost per Click)

Partners earn a fixed amount for each click they drive.

**Example:** $0.01 per click.

### CPL (Cost per Lead)

Partners earn a fixed amount for each qualified lead (signup) they refer.

**Example:** $10 per lead.

### CPS (Cost per Sale)

Partners earn a percentage of each sale they generate — the same calculation as Revenue Share. CPS is always a percentage of the sale amount; there is no fixed-amount-per-sale option.
Partners earn a percentage of each sale they generate, the same calculation as Revenue Share. CPS is always a percentage of the sale amount; there is no fixed-amount-per-sale option.

**Example:** 20% on a $100 sale = $20.

### Coming Soon

| Type | Description | Example |
|------|-------------|---------|
| **Tiered** | Bonuses at milestones | $100 bonus after $100K revenue |
| **Hybrid** | Combine multiple types | CPC + CPS + milestone bonuses |

---

## Commission Duration
Expand Down Expand Up @@ -129,15 +110,15 @@ The 12 months count from the customer's first click, not the first payment: a cu

You can update your default commission anytime in Program Settings.

**Important:** A change does not rewrite commissions that already exist, but it does apply to every new commission from the date it takes effect — including recurring payments from customers referred before the change. Lowering the rate lowers what partners earn on their existing subscribers' future renewals.
**Important:** A change does not rewrite commissions that already exist, but it does apply to every new commission from the date it takes effect, including recurring payments from customers referred before the change. Lowering the rate lowers what partners earn on their existing subscribers' future renewals.

If you lengthen the duration, payments that earned nothing under the old duration (because it had run out) can be credited retroactively at the new policy. Those backpaid commissions go through the hold period again and carry the platform fee, so they appear on a later invoice.

---

## Different Rates for Different Partners

Use [partner groups](/docs/brand/groups) to give different partner segments different commission rates — for example, a higher rate for top performers or a separate rate for agencies. Each group carries its own commission policy, and every partner belongs to exactly one group.
Use [partner groups](/docs/brand/groups) to give different partner segments different commission rates: for example, a higher rate for top performers or a separate rate for agencies. Each group carries its own commission policy, and every partner belongs to exactly one group.

---

Expand All @@ -157,7 +138,7 @@ Use [partner groups](/docs/brand/groups) to give different partner segments diff

<VerifySuccess
dashboard={["Groups shows your group with the new rate in the Commission column", "Server API test sales (`additional_data: { test_mode: true }`) create no commission. The synthetic verification chain (see [Testing Integration](/docs/brand/tracking/testing-integration)) checks that a click, lead and sale attribute end to end; its test commission is listed under Commissions with the label Test but kept out of the summary counts and partner earnings, so the rate itself shows on the first live sale"]}
ifNotWorking={["Partners inherit the policy of the group they are IN — check the partner's group on the Partners table before assuming the rate is wrong"]}
ifNotWorking={["Partners inherit the policy of the group they are IN. Check the partner's group on the Partners table before assuming the rate is wrong"]}
/>

## What's Next
Expand Down
24 changes: 24 additions & 0 deletions scripts/retired-claims.json
Original file line number Diff line number Diff line change
Expand Up @@ -376,5 +376,29 @@
"why": "The code only proves that copying the fields to the Checkout Session's metadata creates no additional subscription sale; it is not a general no-effect guarantee.",
"since": "2026-11-08",
"allow": []
},
{
"pattern": "Existing tracking links\\*\\* continue to resolve|never breaks partner URLs|tracking links keep working|click, lead, and sale events\\*\\* continue|not a tracking kill switch",
"why": "A program that is not active, including one paused for an overdue invoice, records no clicks: the click call answers 410 link_disabled. Leads and sales linked to earlier recorded clicks remain subject to the usual attribution rules.",
"since": "2026-11-11",
"allow": []
},
{
"pattern": "returns to active automatically (once|when) the overdue invoice is marked paid|marking the invoice paid resumes the program",
"why": "An overdue pause lifts only when no invoice of the program is still open (pending or overdue), and only for a pause the overdue check made. Paying the overdue invoice while a newer one is still open leaves the program paused.",
"since": "2026-11-11",
"allow": []
},
{
"pattern": "fixed amount for each (click|qualified lead)|How much partners earn \\(percentage or fixed amount\\)|CPC \\+ CPS \\+ milestone bonuses",
"why": "Current dashboard settings offer One-time, Recurring and Lifetime sale commissions. Per-click and per-lead policies are unavailable as paid commission options.",
"since": "2026-11-11",
"allow": []
},
{
"pattern": "Bonuses at milestones|\\$100 bonus after \\$100K revenue",
"why": "There is no milestone bonus in the product, and the docs do not list commission types that have not shipped.",
"since": "2026-11-11",
"allow": []
}
]
Loading