Getting Started
Welcome to Refgrow! This guide will help you set up and manage your referral program effectively.
Setting Up Your Referral Program
- Log in to your Refgrow dashboard.
- Click on "Add New Program" to create your first referral program.
- Set your referral percentage and other program details.
- Configure your payment integration (Stripe or LemonSqueezy).
Customizing Your Refgrow
Personalize your referral page to match your brand:
- Choose colors for your primary and secondary elements.
- Customize text for titles and descriptions.
- Toggle visibility of various elements like daily stats or branding.
Integrating with Your Website
To add the referral program to your website, follow these steps:
Option 1: With User Authentication
If your website has user authentication, use this code and dynamically set the user's email:
<div id="refgrow" data-project-id="YOUR_PROJECT_ID" data-project-email="user@example.com"></div>
<script src="https://refgrow.com/js/page.js"></script>Parameters:
- data-project-id: Your unique project ID (replace YOUR_PROJECT_ID with your actual project ID)
- data-project-email: The email of the currently logged-in user (replace dynamically when rendering your page)
Option 2: Without User Authentication
If you don't have user authentication or want to use the referral page's built-in authentication, use this code:
<div id="refgrow" data-project-id="YOUR_PROJECT_ID"></div>
<script src="https://refgrow.com/js/page.js"></script>Parameters:
- data-project-id: Your unique project ID (replace YOUR_PROJECT_ID with your actual project ID)
Note: This option will use the referral page's built-in authentication system.
Important Notes
- Place this code where you want the referral program to appear on your website.
- For Option 1, ensure you dynamically set the user's email when rendering your page.
- For Option 2, users will need to authenticate through the referral page interface.
- The referral program will automatically adapt to your website's styling.
- You can customize the appearance of the referral program in your project settings.
Tracking Conversions
Refgrow offers multiple ways to track conversions:
1. Manual Tracking
Refgrow(value, type, email);Parameters:
- value: The monetary value of the conversion (use 0 for non-monetary conversions like signups)
- type: The type of conversion ('signup' or 'purchase')
- email: The email of the user who completed the conversion
Examples:
<!-- Track a signup -->
Refgrow(0, 'signup', 'user@example.com');
<!-- Track a purchase -->
Refgrow(99.99, 'purchase', 'user@example.com');2. Stripe Integration
To integrate with Stripe:
- Go to your project settings
- Click "Create Stripe API Key" button
- Copy the generated API key
- Paste it back in the settings
Note: The system will automatically configure webhooks and start tracking your Stripe payments.
3. Lemonsqueezy Webhook Setup
- Go to your Lemonsqueezy Dashboard > Settings > Webhooks
- Click "Add webhook"
- Set the webhook URL to:
https://refgrow.com/api/webhook/lemonsqueezy/YOUR_PROJECT_ID - Replace YOUR_PROJECT_ID with your actual project ID
-
Select the following events:
- order_created
- subscription_created
- subscription_updated
- Click "Create webhook" to save
Ensure you have set your Lemonsqueezy API Key in your project settings.
Important Notes
- The tracking.js script must be included on all pages where you want to track referral clicks and conversions.
- For manual tracking, ensure that you call the Refgrow function after the tracking script has loaded and when you're certain the conversion has occurred.
- Handle any errors that may occur during the tracking process to ensure a smooth user experience.
- You can change the conversion tracking method in your project settings at any time.
Managing Payouts
Refgrow now offers both manual and automatic payout options for managing payments to your affiliates:
1. Accessing the Payments Page
Navigate to the "Payments" section in your project dashboard. Here, you'll see a list of all your referrals and their earnings.
2. Viewing Referral Information
For each referral, you'll see:
- Their referral code
- Email address
- Total earnings
- Payment status (paid or unpaid)
- Payment method (e.g., Wise, PayPal)
- Payment details (account information)
3. Processing Automatic Bulk Payouts
To use the automatic bulk payout feature:
- Ensure you have set up your PayPal or Wise integration in the project settings.
- On the Payments page, select the referrals you want to pay out using the checkboxes.
- Choose the payment method (PayPal or Wise) from the dropdown menu.
- Click the "Process Bulk Payout" button.
- Confirm the action when prompted.
- The system will process the payouts automatically and update the payment status for each referral.
Note: Automatic bulk payouts are available for users on the Pro and Enterprise plans.
4. Processing Manual Payouts
For users who prefer manual control or are on the Basic plan:
- Review the unpaid earnings for each referral.
- Use the payment method and details provided to send the payment manually through the respective platform (e.g., Wise or PayPal).
- After sending the payment, find the referral's row in the Payments page.
- Click the button to mark the payment as completed. This will update the payment status in the system.
5. Payment History
The Payments page shows the history of previous payouts, including the date of the last payment for each referral. You can use this to track both manual and automatic payouts.
6. Setting Up Payment Integrations
To use automatic bulk payouts, you need to set up your payment integrations:
- Go to your project settings.
- Scroll to the "Payment Integration Settings" section.
- Enter your PayPal Client ID and Client Secret for PayPal integration.
- Enter your Wise API Token and Profile ID for Wise integration.
- Save your settings.
Keep your API credentials secure and never share them publicly.
Note: It's important to keep track of your payments and ensure they match the records in your Refgrow dashboard. Regular reconciliation can help prevent discrepancies.
Frequently Asked Questions
Yes! You can try Refgrow for free to see how it works for your SaaS.
Integration is simple - just add our tracking script and widget code snippet to your website, and you're ready to go. We also provide detailed documentation for more advanced setups.
Absolutely! You can customize the design, reward structure, and other aspects to match your brand and business goals.
Yes, you can cancel or upgrade your subscription at any time from your dashboard.
No, there are no limits on how much your affiliates can earn through referrals.
We offer both manual and automatic payout options. For Pro and Enterprise users, we provide automatic bulk payouts through integrations with PayPal and Wise, making it easy to reward your affiliates. Users on the Starter plan can still process payouts manually. You can choose the method that best suits your needs and workflow.
Yes, we support integrations with Stripe and LemonSqueezy, as well as manual conversion tracking by calling the JS function.
Our system is flexible and supports two authentication scenarios. If your website already has a user authentication system, you can easily integrate our referral program by dynamically passing the user's email. Alternatively, if you don't have your own authentication or prefer a simpler setup, we provide a built-in authentication method specifically for the referral page. This allows you to choose the option that best fits your website's structure and needs.
For any additional questions, please don't hesitate to contact our support team via live chat.
