How should a Stripe credit note affect affiliate commission?
Short answer: Recalculate the commissionable amount of the affected invoice under your published policy, then record a single traceable commission adjustment for the eligible credit. Do not independently reverse the same commission for a credit note and again for the refund created by that note. A Stripe credit note changes the invoice's economic value; how the customer receives the credit is a separate settlement detail.
Stripe's credit note documentation explains that credit notes can reduce the balance of an open invoice or adjust a paid invoice through a refund, customer credit balance or an outside-of-Stripe credit. The distinction matters because affiliate programs often track both invoice events and payment or refund events.
Open versus paid invoices: what changes?
| Situation | Stripe treatment | Affiliate ledger treatment |
|---|---|---|
| Credit note on an open invoice | Amount due decreases; no payment is recorded by the credit note | Reduce any provisional eligible base; do not invent a cash refund |
| Credit note brings open invoice amount due to zero | Invoice can transition to paid with no new cash collection | Do not mistake the status transition for new paid revenue |
| Credit note on a paid invoice, refunded to card | Refund and credit note reference the same adjustment | Post one commission reversal, not two |
| Credit note on a paid invoice, credited to customer balance | Value becomes customer credit for future invoices | Apply policy to the credited amount; prevent a second reward when balance is reused |
| Credit note on a paid invoice, settled outside Stripe | External adjustment is recorded | Record the credit note and external settlement reference for audit |
Stripe recommends crediting specific invoice line items where possible because line-level credits are easier to attribute. The programmatic credit notes guide documents line items, refund amounts, credit amounts and out-of-band adjustments. Tax treatment and eligibility may vary by your contract, so do not blindly apply the full gross credit to a net-revenue commission base.
Use one invoice-level commission adjustment formula
For a simple percentage program, the proposed rule is: commission adjustment = eligible credited revenue × original commission rate. The credit should be allocated to the same eligible invoice lines and policy version as the original reward. For fixed bounties, the rule may instead require a full reversal only when a qualifying activation or retention condition fails. Document the difference.
Example: A hypothetical $120 eligible paid invoice generated a 20% commission of $24. Later, a $30 eligible credit note is issued. Suppose $20 is refunded and $10 becomes customer credit. The correct reduction is $30 × 20% = $6, leaving $18 commission on $90 eligible value. It is not a $6 reversal plus another $4 reversal for the refund. The refund is a settlement of the already-recorded credit. If tax or ineligible services are present, first allocate the credit to eligible lines.
Recommended reconciliation ledger fields
stripe_invoice_id,invoice_line_idandstripe_credit_note_idfor traceability.- Original eligible amount, credited eligible amount, currency and tax exclusion method.
- Original commission entry ID, affiliate ID, rate and policy version.
- Credit disposition: refund, customer balance, outside-of-Stripe credit or a combination.
- Reversal entry ID, event ID, created timestamp and posting status.
- Reconciliation result and exception reason if the source invoice cannot be matched.
Use an append-only reversal or adjustment entry rather than silently editing a previously paid commission. If an affiliate has already received the money, apply the published clawback or negative-balance process. Our commission clawback guide covers the policy side; our Stripe plan change attribution guide covers the subscription lifecycle.
Process credit note and refund events idempotently
- Receive a Stripe event, verify its signature and record its unique event ID.
- Retrieve the relevant credit note and invoice from Stripe using the current API representation.
- Locate the original commission entries by invoice and line item.
- Compute the net eligible adjustment and post a uniquely keyed ledger entry using the credit note ID.
- When a refund event arrives, link it to the existing credit note adjustment if applicable rather than posting a second reversal.
- Reconcile daily against Stripe invoice, credit note and refund records, including failed or pending refund outcomes.
Stripe's event type reference lists credit note and refund event families. Webhook delivery may be repeated or arrive out of order. An event is a signal to reconcile the current objects, not permission to assume the business state is final.
Edge cases that commonly break reporting
Partial credits: Allocate only the credited portion of eligible line items. Credit balance reuse: Decide whether future invoices funded by earlier credit qualify for fresh commissions; do not count the same economic value twice. Voided notes: Stripe permits voiding credit notes on open invoices, which reverses the invoice adjustment; reconcile any provisional commission accordingly. Multiple affiliates: Split the adjustment according to the original attribution shares, not today's partner assignment.
For a recurring program, preserve customer and subscription attribution across plan changes, but calculate commission from the adjusted eligible invoice. A credit note on an open invoice can reduce its amount due to zero, so a paid invoice status alone is insufficient proof of new revenue. Review source amounts and payment movements together.
Finance and engineering QA checklist
- Test open invoice credits, paid invoice refunds and customer-balance credits.
- Verify one commission adjustment for a credit note plus related refund.
- Test multiple partial credits and tax-inclusive invoices.
- Check already-paid affiliate balances and future offsets.
- Replay webhook events and confirm no duplicate reversal.
- Reconcile credited invoice lines to partner statements and the general ledger.
Frequently asked questions
Is a Stripe credit note the same as a refund?
No. A credit note adjusts a finalized invoice. For a paid invoice, Stripe may apply that credit through a refund, customer credit balance or other settlement method.
Should a credit note always cancel the entire affiliate commission?
No. Partial eligible credits usually call for proportional adjustments under a percentage policy. Fixed bounties and milestone programs may have different contractual rules.
Can a zero-due invoice be treated as new paid affiliate revenue?
Not automatically. A credit note can reduce an open invoice to zero and cause a paid status without new cash collection.
Sources and editorial disclosure
Official references: Stripe credit notes, API integration guide, event types. Documentation reviewed 1 November 2026. Monetary examples are hypothetical. This is operational editorial guidance, not a claim of firsthand Stripe testing, accounting or tax advice.