A customer can start on a low-cost plan, upgrade weeks later, and create more partner revenue than the original sale. Rewardful partner upgrades need a clean link between the referral, the Stripe customer, and each paid invoice.
The dashboard can’t repair a broken checkout handoff. If Rewardful never receives the referral ID with the customer record, the partner may get no credit for the upgrade.
Set the attribution path first. Then test it with real billing events before partners send traffic.
SET THE ATTRIBUTION RULES BEFORE YOU LAUNCH
Decide what a partner earns before you configure tracking. State whether commissions apply to the first payment, recurring payments, plan upgrades, discounts, refunds, and proration.
Rewardful uses Stripe billing data to calculate commissions. Its affiliate management features cover recurring commissions and payout administration. Your campaign settings still control who qualifies and when a commission becomes payable.
Write rules your partners can understand
Your partner terms should answer five questions:
- Does the commission apply to collected revenue or the plan’s list price?
- Does the partner earn on renewals and higher plans?
- How do discounts, credits, and prorated upgrade invoices affect the amount?
- What happens after a refund, chargeback, or cancellation?
- When does a cleared commission become available for payout?
Don’t promise a flat commission amount on an upgrade if Stripe can prorate the invoice. Rewardful calculates against what the customer paid. A mid-cycle plan change may create a smaller prorated invoice, followed by a larger full renewal invoice.
Treat a paid invoice as the financial record. A plan change without a successful payment is not partner revenue.
Keep attribution periods visible
A referral cookie or attribution period has limits. A visitor can return through another partner’s link. They can clear cookies. They can sign up after the allowed period ends.
Document the campaign name, partner ID, referral date, original customer email, and Stripe customer ID. This record gives your team a way to investigate a dispute without guessing.
HOW TO TRACK REWARDFUL PARTNER UPGRADES INSTANTLY
Rewardful’s workflow is Stripe-centered. A partner sends a visitor through a tracked link. Rewardful stores the referral. Your checkout passes that referral into Stripe. Stripe then creates the customer and sends billing events as payments, refunds, renewals, or subscription changes occur.
The important handoff happens before the first payment. Rewardful checks the Stripe customer data for a valid referral value. When that match exists, it can connect later invoice activity to the original partner.
Distinguish plan changes from paid upgrades
A customer can switch from Starter to Pro without completing payment. Stripe may retry a failed card. The subscription may remain past due. None of those states should trigger a final partner alert.
Track these stages separately:
| Stage | What it tells you | Partner action |
|---|---|---|
| Referral captured | The prospect arrived through a partner | No commission yet |
| Stripe customer created | The customer record exists | Check referral data |
| Subscription changed | The plan changed | Wait for invoice payment |
| Invoice paid | Revenue cleared through Stripe | Verify commission |
| Refund or downgrade | Revenue changed after payment | Review adjustment |
Rewardful explains that upgrade and downgrade commissions adjust to actual payments. That includes proration, refunds, and changes to the subscription amount.
Use the dashboard as the attribution record
Your internal alert may arrive first through Stripe. Rewardful is where your affiliate manager confirms the linked partner and commission record.
Open the conversion or customer record and match these fields:
- The customer’s email address and Stripe customer ID.
- The campaign that owns the referral.
- The referring partner’s name and ID.
- The paid invoice amount and commission amount.
- The invoice date, status, and any later adjustment.
For Rewardful partner upgrades, check the original referral first. Do not assign the upgrade based only on a partner’s claim or a recent click report.
CONFIGURE THE CHECKOUT HANDOFF
The checkout integration determines whether your referral survives the journey into Stripe. Test the exact flow your customers use. A working referral link is not enough.
Pass the referral through Stripe Checkout
For a client-side Stripe Checkout flow, read the Rewardful referral value after the tracking script loads. Pass it into Stripe Checkout as the client reference ID.
For a server-side flow, store the referral when the visitor lands. Retrieve it when your server creates the Checkout Session. Do not rely on a browser value after a long trial or an email confirmation step.
Use this sequence:
- Open a partner’s tracked link in a fresh browser profile.
- Confirm that Rewardful records the referral.
- Start checkout with a test email address.
- Inspect the created Stripe customer and Checkout Session.
- Confirm that the referral value appears in the expected customer path.
- Complete payment and find the conversion in Rewardful.
If a user signs up through a product-led flow, carry the referral through account creation. Store it against the new user before they reach a billing screen.
Check Payment Links and Pricing Tables
Stripe Payment Links and Stripe Pricing Tables need their own setup. You must attach Rewardful’s referral value to the link or pricing table through the supported client reference method.
For Payment Links, enable Stripe’s option to save payment details for future use. This helps Rewardful connect the payment to a Stripe customer and track later billing activity.
Don’t test only the landing page. Test the link on mobile, in an incognito browser, and after a trial conversion. Those paths expose lost parameters and cross-domain problems.
If your billing stack combines custom signup forms, multiple Stripe accounts, and CRM automation, Book A Call before you put partner traffic into production.
CONFIRM THE UPGRADE BELONGS TO THE RIGHT PARTNER
A correct commission needs evidence from both systems. Rewardful tells you which partner owns the customer. Stripe tells you what the customer paid.
Run a controlled upgrade test
Use a real internal partner account or a dedicated test partner. Use a unique email address and record every identifier before payment.
Start with a lower-priced subscription through the partner’s referral link. Confirm the first conversion in Rewardful. Then upgrade the same Stripe customer through the same billing path that live customers use.
After the upgrade invoice is paid, compare the records:
- Rewardful shows the original partner and campaign.
- Stripe shows the same customer ID.
- The invoice is paid, not open, void, or uncollectible.
- The amount reflects the actual charge after credits or proration.
- The Rewardful commission matches your campaign rate and due-date rules.
Keep a screenshot of the Rewardful record and the Stripe invoice for every test case. This becomes your baseline when a live upgrade looks wrong.
Avoid false positives
A subscription dashboard can show a new plan before payment settles. A webhook can report an invoice event before you see the commission record. A refund can reverse the result later.
Send your team a provisional Slack or email alert after the Stripe paid invoice event. Mark it as “awaiting Rewardful check.” Only mark the upgrade as accepted after the Rewardful conversion and commission details match.
BUILD AN INTERNAL UPGRADE ALERT
Rewardful uses Stripe webhooks to process customer and billing activity. Your team can add a second alert layer without replacing Rewardful as the commission record.
Alert on the event that matters
Use a Stripe paid-invoice event as the trigger for an internal notification. Include the Stripe customer ID, email, subscription ID, invoice total, currency, and new plan.
Then assign a reviewer to open Rewardful and check the linked partner. A simple alert format works:
Paid upgrade received. Verify customer ID, original referral, campaign, invoice total, and Rewardful commission before approval.
Rewardful webhooks need an HTTPS endpoint. You can route events to your application or an automation tool such as Zapier. For custom payout workflows, Rewardful supports a payout.due event when a commission reaches its due state.
Keep the alert logic separate from payout logic. A paid invoice is not always a payable partner balance.
Set a review window
Review high-value upgrades daily. Review lower-value upgrades weekly. Use one owner for each exception.
Track the time from invoice payment to confirmed attribution. This shows whether your process is actually catching Rewardful partner upgrades promptly.
FIX MISSING OR INCORRECT PARTNER CREDIT
Most attribution problems come from a missing referral handoff, not a commission calculation problem. Start at the customer record and work backward.
Check the referral path in order
If an upgrade has no partner attached, check these items:
- Confirm the customer entered through a tracked partner link.
- Check whether the referral stayed attached through signup and checkout.
- Compare the Stripe customer ID with the Rewardful customer record.
- Confirm that the invoice belongs to that same customer.
- Review the campaign attribution period and partner status.
- Check for another partner link used after the original visit.
Don’t overwrite historical records to make a report look clean. Add an adjustment record with the date, reason, reviewer, and final decision.
Build a support-ready evidence packet
When you need help, collect the customer email, Stripe customer ID, Rewardful partner ID, campaign name, invoice ID, invoice date, amount, and screenshots of the relevant records.
State what you expected to happen. State what Rewardful shows now. Include the checkout type, such as Stripe Checkout, Payment Links, or a custom billing page.
A Rewardful product walkthrough can help new team members understand the dashboard before they handle live exceptions.
REPORT ON CLEARED REVENUE, NOT ACTIVITY
Clicks show interest. Created subscriptions show intent. Paid and verified upgrades show partner revenue.
Build one monthly record for every partner, campaign, customer, and invoice. Keep original transactions and later adjustments on separate rows.
Use a small operating report
Track these fields in your spreadsheet or database:
| Field | Why it matters |
|---|---|
| Partner ID and campaign | Identifies who should receive credit |
| Stripe customer and invoice IDs | Links the billing evidence |
| Upgrade date and paid amount | Shows collected revenue |
| Commission status | Separates created, due, paid, and reversed amounts |
| Adjustment reason | Preserves refunds, downgrades, and disputes |
Review paid upgrades, refunds, reversal rate, and total payable commissions. Don’t measure program health by the number of referral clicks or alerts.
KEEP THE CUSTOMER RECORD INTACT
Rewardful partner attribution works when the original referral remains connected to the Stripe customer. Every later invoice can then follow that connection.
Test each checkout route. Confirm paid invoices against Rewardful. Keep adjustments visible instead of rewriting the past.
A clean attribution record protects both your partner relationship and your commission budget.
FAQ
Does Rewardful credit a partner when a customer upgrades?
Rewardful can track later subscription activity for an attributed Stripe customer. The commission follows the amount the customer actually pays. Check the paid invoice and the Rewardful conversion record before you approve it.
Why did a plan upgrade not create a commission?
The referral may not have reached Stripe. The invoice may not be paid. The customer may fall outside the campaign’s attribution rules. Start by matching the Stripe customer ID to the Rewardful conversion.
Do refunds change an upgrade commission?
Yes. A full refund can remove the related commission. A partial refund can reduce it. Keep the original upgrade row and add a separate adjustment row so your payout history remains auditable.
