From 26234ebe797d911349b9477040c922a3f23c7bf4 Mon Sep 17 00:00:00 2001 From: sonpiaz Date: Sat, 17 Oct 2026 00:56:08 -0700 Subject: [PATCH] fix: docs say a refund lowers the revenue counted toward the fee-free tier Co-Authored-By: Claude Opus 5.5 (1M context) --- content/docs/api-reference/track-refund.mdx | 3 ++- .../docs/brand/quickstart/commission-approval-cash-flow.mdx | 4 ++-- content/docs/faq/index.mdx | 4 ++-- content/docs/getting-started/pricing-performance-model.mdx | 4 ++-- 4 files changed, 8 insertions(+), 7 deletions(-) diff --git a/content/docs/api-reference/track-refund.mdx b/content/docs/api-reference/track-refund.mdx index e5895748..674d109a 100644 --- a/content/docs/api-reference/track-refund.mdx +++ b/content/docs/api-reference/track-refund.mdx @@ -2,7 +2,7 @@ title: Track Refund description: Reverse a commission when a sale is refunded kind: reference -last_updated: 2026-10-15 +last_updated: 2026-10-17 --- `POST /api/v1/track/refund` @@ -150,6 +150,7 @@ When a commission is reversed or refunded, Affitor: - transitions the commission to `reversed` or `refunded` status - if the commission was already credited to the partner (any status past `pending`, and not a test), deducts the proportional amount from the partner's balance in the same transaction as the status change; the balance can go negative, and open withdrawals are reduced to fit +- lowers the revenue counted toward your program's $10,000 fee-free tier by the refunded amount, never by more than that sale added - sends an in-app notification to the partner - sends a manual-review warning to the advertiser if the commission had already been paid out diff --git a/content/docs/brand/quickstart/commission-approval-cash-flow.mdx b/content/docs/brand/quickstart/commission-approval-cash-flow.mdx index 6f18efd3..99b5b5ed 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-14 +last_updated: 2026-10-17 --- This page traces the journey from an attributed sale through the commission hold, billing, and partner payout. @@ -116,7 +116,7 @@ What happens depends on where the commission is when the refund arrives: - **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, and a refund does not lower the revenue total that counts toward your program's $10,000 fee-free tier. See [Track refund](/docs/api-reference/track-refund) for the API details. +Platform fees already billed are not refunded, and 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/faq/index.mdx b/content/docs/faq/index.mdx index 765bab80..ad4a9fee 100644 --- a/content/docs/faq/index.mdx +++ b/content/docs/faq/index.mdx @@ -2,7 +2,7 @@ title: "Frequently Asked Questions" description: "Common questions about Affitor's pricing, tracking, commissions, and integration options." kind: faq -last_updated: 2026-10-14 +last_updated: 2026-10-17 --- Quick answers about Affitor's pricing, tracking, commissions, and payouts, with links to the full guides where you need more depth. @@ -107,7 +107,7 @@ At a high level: 5. the partner requests a withdrawal, and Affitor sends it ### What happens if there is a refund? -It depends on where the commission is. Before approval, the commission is removed before it reaches the partner. After approval, the amount is taken back from the partner's balance. If the commission was already collected, reconciling with the partner is a manual step and you get a dashboard notification. Platform fees already billed are not refunded, and refunds do not lower the revenue counted toward the $10,000 fee-free tier. See [commission approval and cash flow](/docs/brand/quickstart/commission-approval-cash-flow#refund-handling). +It depends on where the commission is. Before approval, the commission is removed before it reaches the partner. After approval, the amount is taken back from the partner's balance. If the commission was already collected, reconciling with the partner is a manual step and you get a dashboard notification. Platform fees already billed are not refunded, and a refund lowers the revenue counted toward the $10,000 fee-free tier by the refunded amount, never by more than that sale added. See [commission approval and cash flow](/docs/brand/quickstart/commission-approval-cash-flow#refund-handling). --- diff --git a/content/docs/getting-started/pricing-performance-model.mdx b/content/docs/getting-started/pricing-performance-model.mdx index 23825d5e..c1525ee8 100644 --- a/content/docs/getting-started/pricing-performance-model.mdx +++ b/content/docs/getting-started/pricing-performance-model.mdx @@ -2,7 +2,7 @@ title: "Pricing" description: "Affitor pricing: $0/month, $0 setup, 3.5% of partner-generated revenue — and each program's first $10,000 in affiliate-driven revenue is fee-free." kind: concept -last_updated: 2026-10-14 +last_updated: 2026-10-17 --- Affitor charges only when partners generate revenue — no subscription, no setup fee. @@ -48,7 +48,7 @@ Commissions wait out your program's hold period, then are approved and added to ## $10K guarantee -Each program's first $10,000 in affiliate-driven revenue is fee-free. The threshold is counted per program, so every program you run gets its own $10,000. Refunds do not lower the revenue counted toward it. +Each program's first $10,000 in affiliate-driven revenue is fee-free. The threshold is counted per program, so every program you run gets its own $10,000. A refund lowers the revenue counted toward it by the refunded amount, never by more than that sale added. Confirm your exact commercial terms with the Affitor team before launch.