What earns a commission

Which Stripe payments earn, and how the amount is calculated.

Supaffi creates a commission when Stripe reports a payment from a referred customer. A customer is referred when their checkout carried an affiliate's referral, within the program's time to buy.

Sales that earn

Payment	Earns
A one-time purchase through Stripe Checkout, or through a Payment Link, buy button orpricing table	Yes
The first payment of a subscription started that way	Yes
Every renewal of that subscription, including upgrades and downgrades within the same Stripe product	Yes, until the commission duration ends
A free trial that converts	Yes, from the first real payment
A delayed payment method such as SEPA Direct Debit or ACH	Yes, once the money settles

Some payments never earn, even from a referred customer:

Payment	Why
Subscriptions created in the Stripe Dashboard or through the API, without Checkout	No referral reached them.
One-off charges added to an invoice, manual invoices and setup fees	Only the referred subscription's products earn.
A switch to another Stripe product, or an add-on sold as a separate product	Only the referred subscription's products earn.
The part of a payment covered by the customer's credit balance	The customer did not pay it.
Invoices marked paid outside Stripe	The customer did not pay through Stripe.
Failed payments and paused subscriptions	Nothing was paid. Nothing is shown either.
Signups and free trials that never pay	There is no payment to earn on.
Sales you excluded with metadata	See below.

How the amount is calculated

Commission

commission = base × rate / 100, rounded half up to 2 decimals

Part	Rule
Base	What the customer paid for the referred product: after discounts, before tax and shipping.
Tax	Never earns. On tax-inclusive prices, the tax is taken out first. If Supaffi cannot read the tax on a sale, the sale earns nothing and the server log says so.
Credit balance	The part paid from the customer's Stripe balance earns nothing.
Rate	The affiliate's custom rate if they have one, otherwise their program's rate, at the time of the sale.

A commission of zero or less is not recorded. Example: a $49.00 monthly plan with a recurring 20% discount, at a 25% rate, earns 25% of $39.20, which is $9.80 on each payment.

Commission duration

The program's duration decides how many payments of a referral earn. It counts once per referral, from the referral's first payment.

Program duration	Earns on
of every payment, forever	Every payment, for as long as the subscription pays.
of every payment, for some months	Every payment within the set number of months after the first payment.
of the first payment only	The first payment only.

One click is one referral. A customer who cancels and subscribes again through the same referral carries on where the referral was; the duration does not start over.
A new click on an affiliate link is a new referral, with its own duration.
When a subscription is cancelled, it earns nothing more. Commissions it already earned stay. See Cancellations.
With several products on one Stripe account, a renewal pays only the affiliate who referred that specific subscription.

Exclude a customer or sale

To stop a sale from earning, set the metadata key supaffi to the lowercase string false on one of these Stripe objects:

Object	Excludes
Customer	Every sale from that customer.
Subscription	That subscription's payments.
Invoice	That one payment.

Set it before the customer pays, for example in subscription_data.metadata when you create the Checkout Session:

Checkout Session

await stripe.checkout.sessions.create({
  // ...your existing options
  subscription_data: {
    metadata: { supaffi: "false" },
  },
});

A flag added after payment excludes later renewals only.
A one-time purchase can only be excluded through its customer or its post-purchase invoice.
A sale whose Stripe customer was deleted is treated as excluded.
If Supaffi cannot check the flag, it retries, and after about two days the sale earns nothing.

Currencies

Each commission is in the currency of its sale. Supaffi never converts currencies and never adds different currencies together: totals list each currency separately, and you pay each currency as its own payout.