← View All Guides
Chargebee logo
Integration Guide

How to Apply Chargebee Subscription Credits from Referral Rewards with GrowSurf

Connect Chargebee credits or coupons to GrowSurf rewards so winning participants receive the right subscription incentive automatically.

Want the full setup walkthrough?

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

GrowSurf's Chargebee integration can do two jobs in the same setup: trigger referrals from Chargebee payments and apply Chargebee coupons or credits when a participant unlocks a reward.

If your goal is recurring, stackable subscription value, use the Credits option in GrowSurf's Coupons/Credits tab. GrowSurf then applies the credit to the Chargebee subscription tied to the participant email that earned the reward.

Integration Steps

Connect Chargebee in GrowSurf first

Chargebee integration settings in the GrowSurf campaign editor
Start by adding your Chargebee site, API key, and product catalog version for the correct live or test environment.

In Campaign Editor > 4. Options > Integrations, connect Chargebee with your site name, API key, and product catalog version. If you also want Chargebee payments to trigger referrals, add the webhook username and password GrowSurf expects.

Open the Coupons/Credits tab and connect the reward

Coupons and credits tab for the Chargebee integration in GrowSurf
The Chargebee Coupons/Credits area is where GrowSurf connects a specific reward to Chargebee.

After Chargebee is connected, open Coupons/Credits and click Connect a Reward. Choose the GrowSurf reward that should apply a billing incentive when the participant wins.

Choose Credit when the reward should stack on the subscription

Chargebee credit reward settings inside GrowSurf
Use Credit when the reward should add promotional balance instead of creating a one-time coupon.

Select Credit, then enter the description and credit amount you want GrowSurf to issue. Keep your GrowSurf campaign currency aligned with the Chargebee subscription currency, because Chargebee credits only apply to subscriptions using the matching currency.

Decide who receives the credit and save

If the reward is double-sided, GrowSurf lets you issue the Chargebee credit to the referrer, the referred customer, or both. Save the reward connection after you confirm the right audience and amount.

If Chargebee is only handling reward delivery and not referral triggering, disable Referral Trigger in the integration so the setup reflects your actual workflow.

Test in the right mode and verify the result

Chargebee live mode and test mode are separate. Make sure you are testing in the same mode where the reward was connected, then check the participant activity log and reward details in GrowSurf alongside the matching Chargebee customer or subscription.

If a credit fails to apply, GrowSurf records the issue in the campaign owner notification email and in the participant's reward details. At that point you can fix the mismatch and, if needed, manually issue the reward from Chargebee.

Tips

Use credits for repeatable reward value

Credits are the better fit when every successful referral should add more balance to the same subscription over time. If you only want a single invoice discount, a coupon is usually simpler.

Keep the participant email in sync with Chargebee

GrowSurf matches the reward to the Chargebee customer by email address. If the subscription lives under a different email, the credit will not land on the customer you expect.

FAQ

Should I use a coupon or a credit in Chargebee?

Use a coupon when you want a one-time or duration-based invoice discount. Use a credit when the referral reward should add stackable promotional balance to the subscription.

Can GrowSurf send the Chargebee reward to the referrer, the referred customer, or both?

Yes. For double-sided rewards, GrowSurf lets you choose whether the Chargebee coupon or credit goes to the referrer, the referred customer, or both sides of the referral.

What should I check if a Chargebee credit does not apply?

Start with the participant activity log in GrowSurf, confirm you are in the correct live or test mode, and verify that the Chargebee customer exists under the same email and currency the reward expects.

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.

Trusted by marketing and product teams at fast-growing B2C, fintech, and SaaS companies