Integration Guide

How to Create Stripe Referral Discount Coupons with GrowSurf

Name: GrowSurf
Rating: 4.74 (47 reviews)
Author: GrowSurf

Use GrowSurf to issue Stripe coupons for referrers or referred friends, and optionally surface an upfront promotion code before checkout.

Want the full setup walkthrough?

Use these docs for exact setup steps, supported fields, and troubleshooting.

GrowSurf Stripe integration docs Stripe Payment Links promotions docs

Use the Stripe coupon flow when a referral reward should behave like a discount instead of cash. GrowSurf creates and syncs the coupon in Stripe, while your checkout flow or Stripe Payment Link handles redemption.

This setup also supports upfront referred-friend discounts, so you can give a referred visitor a promotion code before they complete the qualifying purchase.

Integration Steps

Set a default currency and connect Stripe to the campaign

Stripe coupon rewards depend on the campaign currency you choose in GrowSurf. Set that first, then connect Stripe from the campaign Options > Integrations screen.

Open Coupons/Credits and connect the reward you want to automate

Stripe Coupons and Credits tab in GrowSurf — Use the Coupons/Credits tab to connect the referral reward that should create or sync a Stripe coupon.

GrowSurf can connect coupon rewards for the referrer, the referred customer, or both. In double-sided campaigns, this is the area that decides who receives the Stripe coupon.

Choose Coupon and configure the discount

Stripe coupon reward settings in GrowSurf — Choose *Coupon* when the reward should create a Stripe discount instead of a credit.

Configure the coupon name, discount type, duration, and who should receive it. GrowSurf then creates and manages the Stripe coupon for that reward connection.

Apply stackable rewards to subscriptions when that matches the billing model

For rewards like one free month or recurring subscription discounts, GrowSurf recommends applying the coupon to subscriptions rather than customers. If you need the reward to accumulate more like balance, consider using Stripe credits instead.

Use Payment Links or the JavaScript SDK for upfront referred-friend discounts

If you use Stripe Payment Links, GrowSurf can append the promotion code to the Payment Link URL as long as promotion codes are enabled in Stripe. If you use your own checkout flow instead, you can read the promotion code from the GrowSurf JavaScript SDK and apply it there.

Code Snippets

Use this only when you are not relying on Stripe Payment Links to auto-append the promotion code:

const discount = growsurf.getUpfrontDiscount('stripe');
if (discount) {
  console.log(discount.promotionCode);
  console.log(discount.couponId);
}

Tips

Upfront discounts only work for double-sided referred-friend coupons

They do not apply to credit rewards or referrer-only coupon rewards, so confirm the reward structure before you expect a promotion code to appear at checkout.

Changing the referred-friend coupon settings re-syncs the promotion code

GrowSurf replaces the old upfront coupon when you change the referred-friend coupon setup, but customers who already redeemed the previous code are not retroactively changed.

FAQ

Do I need custom JavaScript if I use Stripe Payment Links?

No. When Payment Links are enabled for promotion codes, GrowSurf can append the Stripe promotion code automatically for referred visitors.

Can both the referrer and the referred customer get a coupon?

Yes. In a double-sided reward, GrowSurf lets you choose whether the Stripe coupon goes to the referrer, the referred customer, or both.

Can upfront discounts be used with dynamic rewards?

No. Upfront discounts are incompatible with dynamic rewards, so use a standard referred-friend coupon if you want the promotion code delivered before purchase.

GrowSurf for Startups Program

Startups get a 50% discount

GrowSurf Deals

Get $234k+ In Software Savings

LoyaltySurf

Reward Your Customers For Their Loyalty

Startup Growth Tactics Quiz

How to Create Stripe Referral Discount Coupons with GrowSurf

Integration Steps

Set a default currency and connect Stripe to the campaign

Open Coupons/Credits and connect the reward you want to automate

Choose Coupon and configure the discount

Apply stackable rewards to subscriptions when that matches the billing model

Use Payment Links or the JavaScript SDK for upfront referred-friend discounts

Code Snippets

Tips

Upfront discounts only work for double-sided referred-friend coupons

Changing the referred-friend coupon settings re-syncs the promotion code

How to Set Up Stripe Subscription Referral Rewards with GrowSurf

How to Automate Stripe Customer Credits for Referral Rewards

How to Trigger Referrals from Stripe Subscription Charges with GrowSurf

FAQ

Do I need custom JavaScript if I use Stripe Payment Links?

Can both the referrer and the referred customer get a coupon?

Can upfront discounts be used with dynamic rewards?

Unlock the power of word-of-mouth marketing anddeepen your bond with customers

Set up your refer a friend program with customer referral and affiliate program software that lowers your acquisition costs, increases customer loyalty, and saves you gobs of time.

Built for startups,scaled for unicorns

View GrowSurfCustomer Examples

Unlock the power of word-of-mouth marketing and
deepen your bond with customers

Built for startups,
scaled for unicorns

View GrowSurf
Customer Examples