An affiliate can send a $29 customer who becomes a $299 account six months later. If the referral breaks at checkout, your affiliate report becomes a spreadsheet problem.
Rewardful affiliate tracking connects the referred Stripe customer to later billing activity, including paid upgrades. It works well when attribution, customer records, and payout rules all use the same source of truth.
Set the rules first. Then connect Stripe, test the billing path, and review commissions before you pay anyone.
HOW REWARDFUL AFFILIATE TRACKING HANDLES UPGRADES
The workflow is direct. An affiliate sends a visitor through a tracked link. Rewardful records the referral during the campaign cookie window. Your signup or checkout flow passes the referral into Stripe when it creates the customer.
Stripe then handles the subscription, invoices, payments, refunds, and plan changes. Rewardful receives relevant Stripe events, checks the customer attribution, and records the Conversion and Commission.
What changes when a customer upgrades
A subscription upgrade creates new billing activity in Stripe. If the customer is already a valid referred Conversion, Rewardful can adjust the affiliate commission based on that activity.
For example, a customer starts on a $49 monthly plan and upgrades to $149 halfway through the month. Stripe may create a prorated invoice. Rewardful’s custom Stripe integration guidance says commissions adjust for upgrades, downgrades, cancellations, free trials, and refunds.
The commission should follow the final amount paid, not the plan’s list price. A discount, account credit, or proration can change the invoice total.
What Rewardful does not control
Rewardful tracks attribution and calculates commissions. Stripe processes the charge and owns the subscription record.
Rewardful cannot issue a Stripe refund, change a customer’s subscription, change product pricing, or move money from your Stripe account. Review Rewardful’s current Stripe permission details before granting access.
SET ATTRIBUTION RULES BEFORE YOU LAUNCH
Commission disputes usually start with unclear program terms, not failed software. Affiliates need to know what earns a commission, how long attribution lasts, and what can reverse a payout.
Match the cookie window to your sales cycle
Set the campaign’s Cookie Window in Rewardful based on how customers buy. A 14-day trial with a one-week buying cycle needs different rules than an annual contract that closes after product reviews and internal approval.
State whether your campaign uses first-touch or last-touch attribution. State whether a later affiliate click can replace an earlier referral. Keep these rules in your affiliate agreement.
A referral click proves interest. A paid invoice creates the commission record.
Also define whether commissions are recurring, how many invoices qualify, and whether the rate applies to collected revenue after discounts. Don’t promise a lifetime percentage if the campaign has a renewal limit.
Decide how to handle existing customers
A customer who signed up before your tracking was active isn’t automatically an affiliate Conversion. The same applies when someone clicks an affiliate link on mobile but later subscribes on desktop without the referral data.
Rewardful allows you to manually associate an existing Stripe customer with an affiliate. Future invoices can then qualify for commissions. Record who approved the match, the Stripe customer ID, the affiliate, and the reason. Don’t assign historical revenue without a documented rule.
CONNECT STRIPE AND PRESERVE THE REFERRAL
Use one checkout path for referrals and non-referrals whenever possible. Multiple signup forms, manual invoices, and separate Stripe accounts create gaps that are hard to audit.
Implementation steps
- Connect the Stripe account used for subscription billing to Rewardful. Confirm the account, products, currencies, and live versus test mode.
- Add Rewardful tracking to the pages where affiliates send traffic. Test that a click creates a Visitor or Lead before you test payment.
- In a custom Stripe flow, preserve the referral value when creating or updating the Stripe customer. Rewardful checks for valid
referralmetadata on the customer record. - Keep the same Stripe customer when the buyer upgrades. Creating a second customer can split billing history and attribution.
- If your app creates Checkout Sessions server-side, pass the referral using the integration method Rewardful documents for your stack. Review how Rewardful uses Stripe account data before replacing your checkout code.
Do not build a second commission calculator in your app unless you need internal reporting. Two systems writing payout decisions will create mismatched totals.
TEST UPGRADE SCENARIOS BEFORE GOING LIVE
Run controlled tests through the same pages, billing logic, and Stripe account structure used in production. A successful affiliate click is not enough.
Use this testing checklist
- Create a referred subscription and confirm the correct affiliate, Conversion, and initial Commission appear.
- Upgrade the plan during an active billing period. Confirm the commission reflects the final prorated invoice amount.
- Apply a coupon or account credit, then check that the commission follows the amount Stripe collected.
- Issue a partial refund and a full refund. Rewardful documents commission adjustments for both cases.
- Cancel a subscription before the next renewal. Confirm no unexpected future commission is created.
- Associate one existing customer manually, then verify the affiliate assignment and future invoice behavior.
- Repeat a checkout attempt or resend a test event to check your internal reporting for duplicate rows.
Save screenshots, Stripe customer IDs, invoice IDs, affiliate IDs, dates, and expected results. That record gives support something they can reproduce.
RECONCILE COMMISSIONS LIKE FINANCE DATA
Don’t treat Pending commissions as money available for payout. A refund window still applies. In Rewardful, commissions move from Pending to Due after the configured waiting period.
Keep one row for each commission event in your internal report. Include the affiliate, campaign, Stripe customer ID, invoice ID, refund ID, Rewardful commission ID, status, original amount, adjustment amount, and payout date.
When a refund changes a commission, add an adjustment row. Don’t overwrite the original amount. You need the history when an affiliate asks why a payout changed.
Stripe also warns that webhook endpoints can receive duplicate events. Rewardful’s public documentation does not detail its duplicate-event policy. Store Stripe event IDs and Rewardful commission IDs in your own reporting system, then reject repeats before they create duplicate payout rows.
FINAL CHECK
Rewardful affiliate tracking works when Stripe customer identity stays intact and referral data reaches checkout. Upgrades, refunds, and prorations then have a consistent billing record to follow.
The operating rule is simple: pay affiliates from Due commissions, preserve every adjustment, and investigate exceptions with invoice-level evidence.
