Webhooks

Get real-time notifications about affiliate activities and conversions

Overview

Refgrow uses webhooks to receive real-time notifications about important events from payment processors. These webhooks are essential for tracking conversions and attributing them to the correct affiliates.

Currently, Refgrow supports webhooks for the following payment processors:

  • Stripe
  • LemonSqueezy

Stripe Webhooks

Events Tracked

Refgrow listens for the following Stripe events:

Event Description
checkout.session.completed When a customer completes the checkout process
customer.subscription.created When a new subscription is created
customer.subscription.updated When a subscription is modified

Configuring Stripe Webhooks

To set up Stripe webhooks with Refgrow:

  1. Go to your project settings
  2. Click "Create Stripe API Key" button
  3. Copy the generated API key
  4. Paste it back in the settings
Note: The system will automatically configure webhooks in your Stripe account.

LemonSqueezy Webhooks

Events Tracked

Refgrow listens for the following LemonSqueezy events:

Event Description
order_created When a new order is created
subscription_created When a new subscription is created
subscription_updated When a subscription is modified

Configuring LemonSqueezy Webhooks

  1. Go to your LemonSqueezy Dashboard > Settings > Webhooks
  2. Click "Add webhook"
  3. Set the webhook URL to: https://refgrow.com/api/webhook/lemonsqueezy/YOUR_PROJECT_ID
  4. Replace YOUR_PROJECT_ID with your actual project ID
  5. Select the following events:
    • order_created
    • subscription_created
    • subscription_updated
  6. Click "Create webhook" to save

Ensure you have set your LemonSqueezy API Key in your project settings.

How Conversion Attribution Works

When a webhook event is received, Refgrow automatically:

1. Identify the Customer

Retrieves the customer email from the event data

2. Check for Referral

Looks for an active referral cookie associated with the customer

3. Calculate Commission

Applies your commission rate to the payment amount

4. Record Commission

Saves the commission to the affiliate's account

Testing Your Webhook Integration

Stripe Testing

  1. Switch your Stripe account to test mode
  2. Make a test purchase using a test credit card
  3. Check your Refgrow dashboard to see if the conversion was recorded
  4. View the webhook logs in your Stripe dashboard to verify delivery

LemonSqueezy Testing

  1. Use LemonSqueezy's test mode
  2. Create a test order or subscription
  3. Check that the webhook is delivered (via LemonSqueezy webhook logs)
  4. Verify that the conversion appears in your Refgrow dashboard

Troubleshooting

  1. Verify that your API keys are correctly set in your project settings
  2. Check that the webhook URL is correctly configured in your payment processor
  3. Ensure that you've selected all the required events
  4. Check the webhook logs in your payment processor's dashboard

  1. Make sure your tracking script is properly installed on your website
  2. Verify that the cookie lifetime in your project settings is appropriate
  3. Check that the email address used for the purchase matches the one tracked by Refgrow
  4. Test the complete referral flow from clicking a referral link to completing a purchase

Best Practices

Security
  • Keep your API keys secure
  • Use HTTPS for all communications
  • Regularly review webhook logs
  • Monitor for unusual activity
Reliability
  • Test your webhook integration thoroughly
  • Check your webhook settings after any system changes
  • Keep your payment processor API keys updated
  • Regularly verify that events are being processed

Next Steps

Tracking Setup

Learn more about tracking options and configuration.

View Guide
Stripe Integration

Set up automatic commission tracking with Stripe.

View Guide
Dashboard Integration

Add the affiliate dashboard to your website.

View Guide
Stripe Integration Authentication