An affiliate program fails when referral tracking, commission rules, and payouts live in different places. Your Rewardful affiliate portal puts affiliates in one hosted dashboard where they can access referral links, review commissions, and track payouts.
You still need to build the operating rules behind it. Connect Stripe, configure a campaign, install tracking, test a real referral path, then give affiliates terms they can use.
Set the Program Rules Before You Build
Start with the commercial decision, not the signup page. Affiliates need to know what counts as a qualified referral and what their work can earn.
Choose a commission model that fits your SaaS
Rewardful campaigns can pay recurring commissions by default until the referred customer cancels. That works well for subscription products, but it can create a long-term liability if you do not set limits.
Decide whether affiliates earn on:
- Every paid subscription invoice while the customer stays active.
- A fixed number of payments, such as the first three invoices.
- A fixed period, such as the first 12 months.
- A one-time payment after the first successful charge.
Set a maximum commissions per customer if you only pay for a fixed number of invoices. Set a maximum commission period if rewards should end after a set number of months. If you use both controls, commissions stop when either limit is reached.
A $50 monthly plan with a 20% recurring commission creates a $10 monthly commission. If the customer remains for 12 months, that referral costs $120. Put that number in your unit economics before you publish the program.
Define the attribution and payout rules
Set the referral cookie period, the delay before commissions become due, and a minimum payout threshold. The threshold prevents your team from processing a large volume of $2 and $5 payouts.
Your affiliate terms should state:
- The commission rate and whether it applies to gross or collected revenue.
- The cookie duration and last-click attribution policy.
- Excluded products, discounts, taxes, refunds, chargebacks, and self-referrals.
- When a commission becomes due and when you run payouts.
- The minimum balance required for payment.
- Prohibited traffic, including misleading claims, spam, trademark bidding, or unauthorized coupon sites.
A created commission is not a cleared payout. Refunds, failed payments, cancellations, and attribution changes can alter the final amount.
Keep these rules in a public affiliate terms page. Affiliates cannot price their work properly if the terms only exist in an internal spreadsheet.
Connect Stripe and Create Your First Campaign
Rewardful monitors Stripe activity to create referral records and calculate commissions. Connect the Stripe account that receives subscription payments before you configure the portal.
Grant Stripe access with the right permissions
In Rewardful onboarding, select the option to connect Stripe. Stripe will open its authorization flow, where you approve Rewardful’s requested access. Review the Stripe permissions needed by Rewardful before a finance or security owner approves the connection.
Use the live Stripe account for a live program. Keep test transactions and live revenue separate. A customer referral flow that uses a Stripe customer ID also requires an existing live Stripe customer.
Once Stripe is connected, choose the display currency and create your first campaign. Give it a clear internal name, such as “SaaS Partners, Recurring 20%.” This matters once you add separate campaigns for customers, agencies, creators, or regional partners.
Configure the campaign before inviting anyone
Add the commission rate, payout timing, and limits you chose earlier. Then decide whether the campaign should be public or private.
A public campaign allows people to apply through the hosted Rewardful signup form. A private campaign disables public registration. Use it for hand-picked agencies, customer advocates, or affiliates you recruit directly.
Campaign controls and portal options can differ by Rewardful plan, account configuration, and Stripe setup. Check the live settings in your account before promising an affiliate a payout method or special workflow.
Install Referral Tracking Across the Checkout Path
The portal is only useful if the referral survives the path from content page to paid Stripe customer. Install the Rewardful tracking script on the pages where visitors first arrive.
Match the setup to your checkout method
A Stripe Checkout flow needs the Rewardful tracking script on your site and the required checkout integration. Rewardful’s custom Stripe integration method covers client-side Stripe checkout setups.
If your SaaS uses Next.js, use Rewardful’s current Next.js integration method rather than adapting an old JavaScript example. Referral tracking often breaks when a client-side app drops query parameters during redirects.
For Stripe Payment Links, install the script on the page that contains the payment link. Rewardful’s Payment Links Method B instructions state that the tracking script belongs in footer tracking, not header tracking.
Avoid guest customer gaps
Stripe must create a customer record for the purchase path Rewardful tracks. For Payment Links and Stripe Buy Button flows, enable Stripe’s “Save payment details for future use” setting where Rewardful’s setup requires it.
A guest payment can look successful in Stripe but leave you without the customer data needed for recurring commission tracking. That creates a support problem later, when an affiliate sees the first payment but no renewal commission.
Do not rely on a referral parameter reaching one landing page. Test the full path:
- Open the affiliate link.
- Move through pricing and signup.
- Start checkout.
- Complete a controlled payment where your test setup permits it.
- Confirm the Stripe customer, Rewardful referral, and commission records match.
Configure the Rewardful Affiliate Portal
The Rewardful affiliate portal is the affiliate-facing dashboard. Affiliates use it to find their referral link, view referral activity, check commissions, and review payout status.
Set public signup or use invite-only access
Use public signup when you want applications from creators, review sites, consultants, and existing customers. Add a clear application link to your partner page and explain who the program suits.
Use a private campaign when qualification matters more than volume. You can add or invite approved affiliates through the dashboard, or create affiliate records through the API. The API supports data such as first name, last name, email, campaign ID, PayPal email, and Wise email.
Do not accept every application automatically. Review the applicant’s website, audience, traffic method, geography, and promotional history. A smaller group of qualified partners is easier to support and audit.
Add instructions inside the dashboard
In the campaign settings, open the Affiliate portal section under Advanced settings. Rewardful provides fields for welcome text and affiliate dashboard text.
Use the welcome text to state the offer, approval standard, and prohibited activity. Use dashboard text for practical information after approval:
- Where affiliates should link, such as your pricing page or a product comparison page.
- Which claims need approval before publication.
- How to request custom landing pages, co-marketing assets, or coupons.
- The payout threshold, review period, and support contact.
You can also place useful partner resources in the dashboard text. Add the affiliate token variable to a destination URL when you want an affiliate-facing resource to retain their referral context.
Onboard Affiliates With Links They Can Use
A portal without a launch process becomes a login screen people forget. Send each approved affiliate a short onboarding message within one business day.
Give each partner one first action
Ask the affiliate to log in, confirm payment details, copy their referral link, and place it in one approved location. Do not ask them to publish five posts before they understand the offer.
A practical onboarding message includes the product’s target customer, three approved value points, the affiliate terms link, and the one landing page you want them to promote first.
For example, a B2B reporting tool could ask an agency affiliate to link to its pricing page from a “recommended reporting tools” article. That match is better than sending generic traffic to a homepage.
Create custom affiliate records when needed
API-created affiliates are useful when referral access is part of your product onboarding. A customer referral program can create an affiliate after the customer exists in Stripe, then associate the record with the right campaign.
Use this approach for customer advocates who receive account credit rather than a cash payout. Rewardful’s custom rewards workflow uses the payout.due webhook as the trigger. Your system applies the Stripe credit, then marks the Rewardful payout as paid after the credit succeeds.
If you need help mapping Stripe events, portal access, and approval ownership across your team, Book A Call.
Test Attribution Before You Announce the Program
Do not launch based on a script installation message alone. Run a controlled test before recruiting affiliates.
Verify the tracking script first
Open your site in a private or incognito browser with ?via=install added to the URL. Let the page load fully, then refresh the Rewardful dashboard. This is Rewardful’s standard check for detecting the installed tracking script.
Next, run the purchase test. Use a new browser session, a new email address if needed, and a clean Stripe test or controlled low-risk payment flow. Record each stage in a launch log.
| Checkpoint | What to confirm |
|---|---|
| Referral visit | The affiliate token appears in Rewardful |
| Stripe customer | A customer record exists, not only a guest payment |
| Referral record | The correct affiliate owns the referral |
| Commission | Rate, currency, and due date match campaign rules |
| Payout | The record follows your threshold and approval policy |
The test result should match your written terms. Fix the campaign or checkout path before you add traffic.
Troubleshoot missing or incorrect commissions
Start with the referral record, not the payout screen. Check the customer email in Stripe, campaign assignment, referral date, cookie window, payment status, and refunds.
A missing commission may be valid. The visitor may have used another affiliate’s link later. The customer may have canceled before payment. The purchase may not meet the campaign conditions.
When the customer belongs to the right partner but attribution failed, Rewardful supports manual referral attribution. Use it only after you document why the correction is valid.
Keep a support record with the customer email, affiliate ID, referral URL, Stripe invoice, date range, screenshots, and expected result. Do not overwrite the original history without recording the reason.
Run Payouts and Compliance as an Operating Process
Payouts need a repeatable review. Do not pay based on click counts or pending commissions.
Reconcile cleared commissions before payment
Create a monthly record with one row per affiliate, campaign, and reporting period. Track approved commissions, reversals, refunds, payout status, payment date, and payout reference.
Use this calculation:
Net affiliate payable = approved commissions – reversals – prior adjustments
Keep adjustments as separate rows. If a $120 commission is paid and later reversed, record the reversal with its date and reason. Do not replace the original $120 record. Your team needs the history if a later payout is reduced.
Review retained referred revenue and reversal rate alongside payout totals. If commissions need constant correction, stop expanding the program. Fix campaign rules and checkout tracking first.
Handle disclosures, privacy, and tax data
Require affiliates to disclose their relationship with your business where local advertising rules require it. Their review, newsletter, video, or social post should not hide the fact that they may earn a commission.
Collect only the payout and tax information you need. Limit dashboard access to staff who manage affiliates or finance. Give developers the narrowest Stripe and Rewardful permissions needed for their work.
Tax forms, withholding, VAT, and payout methods depend on your business location and each affiliate’s tax status. Get accounting or legal advice before you make tax claims in your terms.
Final Thoughts
A working Rewardful affiliate portal depends on more than a hosted signup page. The system needs clear commission limits, a tested Stripe path, qualified affiliates, and a payout record that preserves reversals.
Launch with a small approved group. Confirm every referral stage, pay the first cycle correctly, then expand what your team can support.
