diff --git a/content/docs/brand/billing/overdue-policy.mdx b/content/docs/brand/billing/overdue-policy.mdx index 8a7dfecc..f40e3c75 100644 --- a/content/docs/brand/billing/overdue-policy.mdx +++ b/content/docs/brand/billing/overdue-policy.mdx @@ -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. Invoice issued Mon 09:00 UTC Pay within 7 days → **paid:** Status: paid · **past due:** Status: overdue Program paused - Mark invoice paid + No Open or Overdue invoices remain Program auto-resumed @@ -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 ``` @@ -79,11 +82,11 @@ sequenceDiagram Affitor's billing team matches the transfer to your invoice and marks it paid. - 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. -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. --- @@ -106,7 +109,7 @@ Affitor bills through Wise wire transfers. Each invoice page shows the destinati - 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. 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. diff --git a/content/docs/brand/quickstart/commission-approval-cash-flow.mdx b/content/docs/brand/quickstart/commission-approval-cash-flow.mdx index 6e55e190..ccaa6647 100644 --- a/content/docs/brand/quickstart/commission-approval-cash-flow.mdx +++ b/content/docs/brand/quickstart/commission-approval-cash-flow.mdx @@ -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. @@ -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:** @@ -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. diff --git a/content/docs/brand/quickstart/define-commission.mdx b/content/docs/brand/quickstart/define-commission.mdx index 135b2272..5aee695b 100644 --- a/content/docs/brand/quickstart/define-commission.mdx +++ b/content/docs/brand/quickstart/define-commission.mdx @@ -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. @@ -11,7 +11,7 @@ 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. @@ -19,7 +19,7 @@ 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 | --- @@ -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 @@ -129,7 +110,7 @@ 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. @@ -137,7 +118,7 @@ If you lengthen the duration, payments that earned nothing under the old duratio ## 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. --- @@ -157,7 +138,7 @@ Use [partner groups](/docs/brand/groups) to give different partner segments diff ## What's Next diff --git a/scripts/retired-claims.json b/scripts/retired-claims.json index 98f1d2fb..7a166aa6 100644 --- a/scripts/retired-claims.json +++ b/scripts/retired-claims.json @@ -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": [] } ]