Stripe
Note: The Stripe integration is only available to users on a GrowSurf paid plan.
When you connect your Stripe account to your GrowSurf campaign and enable Referral Trigger, GrowSurf will automatically detect and trigger referrals on new Stripe charges.
GrowSurf will check if the Stripe customer's email address matches a GrowSurf participant's email address. If a match is found, then a referral will trigger, giving referral credit to the referrer and unlocking any rewards, if applicable. If a referral has already been triggered (and referral credit already was awarded), then nothing else will happen because referral credit can only be awarded once.
Here's how to set up Stripe referral triggers:
Important Note: Unless your campaign is configured to add participants automagically (see image), you'll need to make sure you first call JavaScript growsurf.addParticipant() or REST API /POST Add Participant to add new participants.
Step 1: In Campaign Editor > 4. Options > Integrations, click the Connect to Stripe button
Step 2: Once connected, GrowSurf will have Referral Trigger enabled by default.
(Optional) Step 3: You can add a referral trigger hold period by toggling the Show advanced settings section.
Note: The referral trigger hold period is useful for preventing fraud and helps minimizes losses due to refunds and chargebacks. During this hold period, if there is a refund or chargeback, the referral trigger will be cancelled completely.
GrowSurf will also update metadata for Stripe customers who trigger referrals.
Metadata Key | Description | Example |
GrowSurf Participant ID | The referred Stripe customer's participant ID |
|
GrowSurf Participant Referred By URL | The URL of the participant who referred the Stripe customer |
|
GrowSurf Participant Referred By Email | The email address of the participant who referred the Stripe customer |
Our Stripe integration comes with a test mode that allows you to test triggering referrals without using live payments. When you toggle Test Mode on, GrowSurf will also process all test mode payments made in your Stripe account.
For more details on Stripe Testing, see here.
When testing out the Stripe Referral Trigger integration, make sure to view participants' activity logs for details that can help you troubleshoot any issues.
When a GrowSurf participant unlocks a reward, apply a coupon to a Stripe customer.
Step 1: In Campaign Editor > 4. Options > Integrations, click the Connect to Stripe button
You must first select a default currency for your GrowSurf campaign in order to use Stripe. Your default currency determines whether Stripe coupons can be applied to your Stripe customers or subscriptions. For example, if your default currency is USD then the coupon that you set up can only be redeemed for Stripe customers or subscriptions that are using USD.
Step 2: Once connected, click the Coupons tab and connect a reward(s) to Stripe by clicking the Connect a Reward button.
Note: When you connect to Stripe, Referral Trigger will enabled by default. If you are triggering referrals another way, disable the toggle in the Referral Trigger tab.
Enter the details of the coupon, including the name, type, and discount. You can also click Show advanced coupon settings to view more customization settings.
Then hit Save. Now, anytime this reward is unlocked by a winning participant, a Stripe coupon will also be applied to the Stripe customer or subscription associated with the GrowSurf participant email address.
With double-sided rewards, you have full flexibility in choosing who gets the coupon reward: (1) just the referrer, (2) just the referred person, (3) or both referrer and referred person.
Once you save the reward, you should see a green dot, indicating that the Stripe Coupons integration is enabled.
GrowSurf will also update metadata for the Stripe coupon with information.
Metadata Key | Description | Example |
GrowSurf Campaign ID | The unique ID of the GrowSurf campaign |
|
GrowSurf Participant ID | The GrowSurf participant that unlocked the Stripe coupon |
|
GrowSurf Participant URL | The URL of the GrowSurf participant that unlocked the Stripe coupon |
|
GrowSurf Reward Description | The description of the GrowSurf campaign reward |
|
GrowSurf Participant Reward ID | The unique ID of the participant's unlocked reward |
|
Our Stripe integration comes with a test mode that allows you to test coupons without using live coupons. When you toggle Test Mode on, GrowSurf will apply coupons only to your Stripe account in test mode. It is important to note that Stripe coupons created in test mode will only apply to Stripe customers and Stripe Subscriptions that exist within your Stripe account when test mode is toggled on.
To enable test mode, toggle the Test Mode switch at the bottom-right, then connect a reward(s).
Please note that the rewards you connect while Test Mode is enabled are completely separate from the rewards you connect while in live mode.
Important note: When you go live with your campaign, please make sure to switch back to live mode.
Only companies based in the following 135+ countries can use the Stripe coupons integration.
If you have manual reward approval enabled for your campaign: Stripe coupons will only be issued to the winner(s) only after you approve the reward.
When testing out the Stripe Coupon integration, make sure to view participants' activity logs for details that can help you troubleshoot any issues.