Stripe Billing and invoice documentation reviewed 11 November 2026. Documentation-based analysis; no live merchant account was tested.
Do SaaS affiliates earn commission when a Stripe invoice is paid with customer credit?
It depends on your commission agreement and what the credit represents. Stripe can mark an invoice paid even when some or all of its amount is covered by a customer’s invoice balance rather than a new card charge. If you pay on net new cash, a credit-funded amount may not qualify today. If a credit is prepaid value from an earlier paid invoice, you need a consistent rule that avoids both underpayment and double counting. Separate invoice status, cash collected and commissionable revenue.
This guide addresses customer invoice balances, not just discount coupons. For broad policy design, read affiliate commissions on discounts and credits. For invoice lifecycle timing, see Stripe invoice finalized vs paid.
Three Stripe balances that should not be confused
Stripe’s official customer invoice balance documentation distinguishes invoice balance adjustments from billing credit grants and customer cash balances. They have different eligibility, audit trails and reversal behavior. Treating all three as one generic coupon creates commission errors.
| Mechanism | Purpose | Affiliate reconciliation question |
|---|---|---|
| Customer invoice balance | Credit or debit adjustments that apply to future invoices | Was this a prior refund/credit, correction or previously funded amount? |
| Billing credit grant | Eligible usage-based subscription credits | Is the discounted usage eligible for commission under program terms? |
| Customer cash balance | Bank-transfer funds available for reconciliation | Was cash collected earlier, and has commission already been recognized? |
| Credit note | Corrects a finalized invoice | Should previously approved commission be reversed or reduced? |
Stripe states that customer invoice balance adjustments normally apply to the next finalized invoice in the matching currency. Credits reduce the amount due; debits increase it. The adjustment ledger is immutable, so reversing a mistake generally requires an opposite transaction. That accounting fact matters for affiliate audit trails: never delete a prior commission entry merely because the balance changed.
Pick a commission basis that you can defend
Option A: net cash collected now
Under this policy, commission is based on new eligible payment collected for the invoice. A $100 subscription invoice with $25 of invoice credit and $75 collected in new cash has a $75 commission base. At a 15% rate, commission is $11.25. This is simple for cash-based programs, but it can exclude value funded by an earlier payment if the credit came from previously collected money.
Option B: recognized eligible subscription revenue
Under a revenue-based policy, you might commission the full $100 of eligible service revenue when the invoice is settled, even if $25 came from an invoice balance. At 15%, the amount is $15. But this is defensible only if the $25 was not already commissioned when originally received. Revenue recognition and affiliate commission policy are separate decisions; ask finance to reconcile the source of each credit.
Option C: exclude goodwill and promotional credits
A program may exclude credits granted as goodwill, service recovery or promotions, while including prepaid customer funds. This requires credit-origin classification in your ledger. Do not try to infer intent from a negative balance number alone. Record a reason code and related original invoice or credit-note ID where possible.
Worked example with an audit trail
Assume an affiliate referred a customer on a $100/month plan. The first month was paid in full and earned a $15 commission. Support then issues a $25 credit against the customer’s next invoice because of downtime. On the second $100 invoice, Stripe applies $25 of invoice balance and collects $75. If the written rule is 15% of net new eligible cash, the second commission is $11.25. Total for two months is $26.25, not $30.
Now consider a different case: the $25 balance arose because the customer prepaid $25 in an earlier transaction that had not earned commission. A policy based on eligible subscription revenue might include that $25 on the second invoice. The calculation changes because the economic origin of the credit changes, not because the Stripe invoice status is different. The affiliate ledger should preserve this explanation for disputes.
Which invoice fields matter?
Stripe’s Invoice API reference exposes fields such as total, amount_due, amount_paid, starting_balance, ending_balance, paid and paid_out_of_band. Interpret them with your API version and payment source; no single field is a universal affiliate commission base. A paid invoice may have been paid through customer credit or marked paid outside Stripe.
- Link the invoice to the correct subscription, customer and original affiliate attribution.
- Read line items and distinguish subscription service revenue from tax, one-time setup fees and non-eligible products.
- Record discounts, credit notes, customer invoice balance applications, billing credit grants and actual payment sources separately.
- Apply the agreed earning policy to each component. Use the invoice ID and policy version as an idempotency key.
- Place the result in a pending ledger until the refund and dispute hold expires, then approve or reverse it.
Edge cases that change the answer
Zero-dollar paid invoice
A paid status does not automatically mean a new $0 commission or a full-price commission. Determine whether it was covered by prepaid value, a promotional grant, a customer balance adjustment or a pricing discount. Document the decision rather than assuming all zero-due invoices are identical.
Credit note after a paid invoice
A credit note can adjust a finalized invoice and may result in a refund or a credit to future invoices. If the original invoice earned commission, reverse the affected portion according to the program’s clawback terms. See our Stripe credit note reconciliation guide.
Different currencies
Stripe requires matching currencies for invoice balance application. If your affiliate payout currency differs from the invoice currency, preserve the source-currency calculation and record the conversion date and rate separately. Do not silently convert a historical commission using today’s FX rate.
Manual paid-out-of-band status
When an invoice is manually marked paid, Stripe’s paid state alone does not establish when funds arrived in your bank account. Reconcile external payment evidence before moving a cash-based commission from pending to payable.
Reconciliation test checklist
| Test case | Expected control |
|---|---|
| Invoice $100, credit $25, new cash $75 | Commission base matches documented credit policy |
| Invoice fully covered by goodwill credit | No unapproved automatic full-price payout |
| Credit note after affiliate payout | Linked reversal entry; historical record preserved |
| Customer balance debit increases invoice | Debit source reviewed before treating as service revenue |
| Webhook delivered twice | One commission per qualifying invoice/rule |
| Paid-out-of-band invoice | External payment reconciliation required if policy is cash-based |
Frequently asked questions
Does Stripe automatically decide affiliate commission on invoice credit?
No. Stripe manages billing and balances. The affiliate program determines eligibility and rates through its own terms or integrated software.
Is customer invoice balance the same as a coupon?
No. A coupon discounts pricing; an invoice balance is a ledger of customer credit or debit adjustments applied to invoices. Billing credit grants and cash balances are separate again.
Can an invoice be paid without a new card payment?
Yes. Stripe’s invoice documentation notes that an invoice can be paid with customer account credit or marked paid outside Stripe. Verify the underlying settlement before awarding cash-based commissions.
Official sources reviewed
- Stripe: customer invoice balance and credit types
- Stripe: Invoice object and payment fields
- Stripe: invoice transitions
Editorial disclosure: This guide uses Stripe’s public documentation reviewed 11 November 2026. Illustrative commission policies are examples, not Stripe defaults or accounting advice. Confirm billing API behavior, tax treatment and your contractual payout rules with your finance team.