Affiliate links are useful until a buyer skips the link and enters a code at checkout. Stripe coupon tracking fixes that gap. Rewardful can assign each affiliate a unique Stripe promotion code, then credit the affiliate when that code is redeemed.
The setup is simple, but the campaign rules and checkout configuration must match. One wrong discount setting can produce a valid customer discount with no usable affiliate record.
Set up the campaign first. Then open the correct promo-code path in Stripe Checkout.
HOW STRIPE COUPON TRACKING WORKS
A Stripe coupon and a Stripe promotion code are not the same object. The coupon contains the discount rules. The promotion code is the customer-facing text an affiliate shares.
Stripe allows multiple promotion codes to point to one coupon. Review Stripe’s coupon and promotion code model before creating your campaign. It prevents a common mistake, which is treating a generic campaign coupon as an affiliate identifier.
Rewardful creates the affiliate-level code
In Rewardful, you configure a campaign discount. Rewardful creates the matching coupon in your connected Stripe account. It then generates a unique promotion code for each affiliate who joins the campaign.
The customer enters that affiliate’s code during checkout. Rewardful uses the redeemed code to associate the customer with the affiliate, even when the buyer never clicked an affiliate link.
Rewardful calls this promotion-code referral tracking. It works as a standalone attribution path or alongside normal referral links.
The code owner receives the attribution
Each promotion code needs one clear affiliate owner. Use codes that are easy to read and hard to confuse, such as MAYA10 or PARTNERJUNE.
Don’t give two affiliates the same code. Don’t ask affiliates to share a generic WELCOME10 discount. Stripe can apply the discount, but Rewardful can’t identify which partner earned the referral.
A code can be reposted by someone else. Stripe coupon tracking still credits the affiliate assigned to that code. It does not prove who personally recommended the product.
DEFINE THE CAMPAIGN BEFORE YOU TURN IT ON
Start with the commercial rules. Decide the discount, commission structure, eligible products, and customer type before you create anything in Stripe.
A clean campaign has one discount design and one clear reason for using it. For example, a 20% first-month discount for new SaaS customers is easier to manage than several overlapping discounts with unclear ownership.
Confirm the Stripe connection and permissions
Connect the Stripe account that receives your live subscription payments. Rewardful needs access to create coupons, generate promotion codes, and sync tracking data with Stripe.
Review the Stripe permissions Rewardful requests before authorizing the connection. Your finance or security owner should know that Rewardful can create coupon objects and update relevant Stripe data for the integration.
Use the same Stripe account for the campaign and checkout. A promo code created in one account won’t work in a Checkout Session created in another.
Choose the right customer rule
Rewardful provides a Limit promo codes to new customers only option. Turn it on if the discount is for first-time buyers.
This setting affects your test plan. A previous customer may see the code rejected or fail to qualify. Test with a new email address when new-customer restrictions apply.
Write the rule in the affiliate terms as well. Partners need to know whether their code works for renewals, upgrades, annual plans, or only a first purchase.
CONFIGURE AFFILIATE PROMO CODES IN REWARDFUL
Open the campaign you want to use. Go to Edit campaign, then Advanced settings, then Affiliate Discounts and Promo codes.
This is the campaign-level setup. Don’t create manual coupons in Stripe first unless Rewardful support has told you to use a custom flow.
Create the campaign discount
Select Enable affiliate discounts. Rewardful will ask for the discount coupon name, discount type, rate, and duration.
Set the discount details to match your offer:
- Use a percentage discount when every plan should receive the same percentage off.
- Use a fixed amount only when the amount makes sense across eligible prices.
- Set the duration to match the offer, such as one month, three months, or the full subscription period.
- Restrict the coupon to the intended products if the campaign should not discount every Stripe price.
The parent coupon controls the base discount terms. Each affiliate promotion code inherits those terms. A code can’t override a restriction on its parent coupon.
Generate one code for every affiliate
Turn on Via promo codes. Then select Generate unique promo codes for every affiliate when they join the campaign.
Save the campaign. Review your active affiliates and confirm each person has a code before you announce the offer. Record the affiliate name, code text, campaign, and launch date in one operating sheet.
A valid discount at checkout is not enough. The promotion code must map to the affiliate you expect to credit.
Rewardful warns that promo codes can’t be disabled after you enable and save them. To stop the program, you remove the campaign coupon code. That deactivates current codes and stops new code generation. Treat the first save as a production change, not an experiment.
OPEN THE PROMO-CODE FIELD IN STRIPE CHECKOUT
Your checkout must give customers a place to enter the affiliate’s promotion code. The correct setup depends on whether you use Checkout Sessions or Stripe Pricing Table.
No separate custom webhook is part of Rewardful’s documented promotion-code setup. Your product provisioning webhook may still create access after payment, but it is not the affiliate attribution mechanism.
Configure a Stripe Checkout Session
For a server-created Checkout Session, set allow_promotion_codes to true. Stripe then shows the promotion-code entry field during checkout.
Use the buyer-entry route when the affiliate shares a unique code. Don’t pre-apply a generic coupon through the Checkout Session discounts array and expect Rewardful to identify an affiliate.
Stripe Checkout supports one coupon or promotion code per Session. Read Stripe’s Checkout discount rules before combining a campaign code with another offer. A second discount path can block the code your affiliate shared.
Test the exact Price IDs in the Session. A promotion code may exist in Stripe but still fail if its parent coupon doesn’t apply to that product.
Configure a Stripe Pricing Table
For Stripe Pricing Table, create or edit the table in Stripe and select Allow promotion codes for each product you want to include.
Install Rewardful’s Step 1 tracking script in the site head. Then add the data-rewardful attribute to the opening stripe-pricing-table element before publishing the embed.
Rewardful’s Stripe Pricing Table instructions tell you not to add the standard Step 2 code for this setup. The pricing-table integration handles the referral UUID through its own path.
After publishing, return to Rewardful and complete the integration check. Test the published page, not only the Stripe Dashboard preview.
TEST ONE COMPLETE ATTRIBUTION PATH
Run a controlled test before affiliates promote the code. Use one internal affiliate, one campaign, one eligible plan, and one new test customer.
An incognito or private browser window prevents an old referral cookie, existing login, or saved customer session from affecting the result.
Run the checkout test
Use this sequence:
- Copy the exact promotion code assigned to your test affiliate in Rewardful.
- Open the production-like checkout flow in a private browser session.
- Use a new customer email if the campaign limits codes to new customers.
- Enter the promotion code, confirm that Stripe applies the expected discount, and complete the approved test payment.
- Check the resulting customer and conversion records in Rewardful.
Don’t test with a code copied from a spreadsheet that has been edited manually. Copy it from the affiliate record first. This catches code-transcription errors before partners see them.
Validate both Stripe and Rewardful
Check the completed Checkout Session in Stripe. Confirm the correct customer, product, discount, and promotion code appear on the payment record.
Then check Rewardful. Confirm the customer is attributed to the intended affiliate and that the conversion appears under the expected campaign.
A completed Checkout Session proves that Stripe processed a payment. It does not prove that Rewardful credited the intended affiliate.
Mark the test as Passed only when both records match. If the discount works but the attribution is missing, pause the launch. Check the campaign, code owner, Stripe account connection, and checkout configuration before creating more codes.
LIMITS THAT AFFECT PROMO-CODE ATTRIBUTION
Promotion-code campaigns are not interchangeable with every Rewardful coupon feature. Keep the tracking method clear.
Don’t confuse promo codes with double-sided incentives
Affiliate promo codes connect a redemption to a code owner. Double-sided incentives use a different flow. They can apply a customer discount after a tracked referral visit, often through referral-link and cookie data.
Rewardful’s double-sided incentive setup may require you to pass the campaign coupon ID into your Stripe implementation. That is not the same as letting a buyer enter an affiliate’s unique code.
Use promo-code tracking when the code itself is the referral identifier. Use double-sided incentives when you need a referral link to trigger a customer reward and an affiliate reward.
Plan for code restrictions and conflicts
Promotion codes inherit the limits of the parent coupon. Product limits, first-time-customer rules, expiry dates, and redemption caps can all stop a valid-looking code.
Stripe also limits a Checkout Session to one coupon or promotion code. Review Stripe’s advanced discount limits before promising stackable affiliate offers.
Don’t change a live campaign discount without a written rollout plan. A new coupon rule can affect every affiliate code tied to that campaign. Create a separate campaign when the commercial offer changes materially.
KEEP A SMALL ATTRIBUTION AUDIT TRAIL
Coupon programs create revenue data. Treat the records like finance data, not marketing screenshots.
Keep one campaign record with the items below.
| Record | Store | What to verify |
|---|---|---|
| Campaign | Rewardful campaign name and Stripe coupon | Discount rate, duration, products, and customer rules |
| Affiliate code | Affiliate name and promotion code | One owner for every code |
| Test payment | Stripe Checkout Session ID and customer ID | Code applied to the intended product |
| Conversion | Rewardful referral and commission record | Correct affiliate and campaign credit |
Use simple statuses: Draft, Test passed, Live, and Needs review. Keep the original Stripe and Rewardful records unchanged. Add correction notes beside them if a code is reassigned or a campaign is retired.
Review the first five redemptions after launch. Then review again after any campaign or checkout change. Measure accepted affiliate attributions, not checkout visits or the number of codes created.
FINAL THOUGHTS
Stripe coupon tracking works when the campaign coupon, affiliate promotion code, Checkout configuration, and Rewardful conversion record agree.
Start with one campaign and one controlled redemption. Confirm the payment and attribution records before inviting more affiliates.
The code is only reliable when you can trace it back to one affiliate, one Stripe session, and one approved campaign.
