Stripe Integration

Learn how to set up automated commission tracking with Stripe

Overview

Refgrow integrates with Stripe to automatically track payments and calculate commissions for your affiliates. This integration enables:

  • Automatic tracking of payments
  • Accurate commission calculations
  • Real-time conversion attribution
  • Multi-currency support
  • Detailed payment tracking

Prerequisites

Note: You'll need a Stripe account to track payments. If you don't have one, sign up here.

Requirements

  • A Stripe account
  • Refgrow project set up with commission settings
  • Admin access to your Stripe dashboard

Setting Up Stripe Integration

Easy Setup Method

Refgrow offers a simplified setup process for Stripe integration:

  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 and start tracking your Stripe payments.

Commission Configuration

Configure your commission structure in your project settings:

  • Set your commission percentage
  • Choose between percentage or fixed amount commission
  • Configure commission duration (lifetime or limited period)

How It Works

1. Referral Click

A user clicks an affiliate's referral link and a tracking cookie is set.

2. Stripe Payment

The user makes a payment through your Stripe checkout or subscription.

3. Automatic Commission

Refgrow automatically attributes the sale and calculates the commission.

Supported Stripe Events

Refgrow listens for the following Stripe webhook events:

  • checkout.session.completed - When a purchase is completed
  • customer.subscription.created - When a new subscription is created
  • customer.subscription.updated - When a subscription is updated

Managing Payouts

Accessing the Payments Page

To manage payments to your affiliates:

  1. Navigate to the "Payments" section in your project dashboard
  2. View all your referrals and their earnings
  3. See payment status (paid or unpaid) for each affiliate

Manual Payouts

To process manual payouts:

  1. Review the unpaid earnings for each referral
  2. Use the payment method and details provided to send the payment manually through the respective platform (e.g., Wise or PayPal)
  3. After sending the payment, find the referral's row in the Payments page
  4. Click the button to mark the payment as completed

Automatic Bulk Payouts

For Pro and Enterprise plan users:

  1. Ensure you have set up your PayPal or Wise integration in the project settings
  2. Select the referrals you want to pay out using the checkboxes
  3. Choose the payment method (PayPal or Wise) from the dropdown menu
  4. Click the "Process Bulk Payout" button
  5. Confirm the action when prompted

Multi-Currency Support

Refgrow supports multiple currencies through Stripe:

  • Automatically tracks payments in different currencies
  • Calculates commissions in the currency of the transaction
  • Displays earnings in the original transaction currency

Security Best Practices

API Security
  • Keep your Stripe API keys secure
  • Use HTTPS for all communications
  • Regularly review your Stripe webhooks
  • Monitor for suspicious activity
Payment Security
  • Verify affiliate payment details
  • Double-check payment amounts
  • Keep records of all transactions
  • Regularly reconcile commissions

Troubleshooting

  1. Check that your Stripe API key is correctly set in your project settings
  2. Verify that the webhook is properly configured in your Stripe dashboard
  3. Ensure the required events are enabled
  4. Check your Stripe dashboard logs for any webhook errors

  1. Ensure your tracking script is installed on all relevant pages
  2. Check that the cookie lifetime is appropriate for your sales cycle
  3. Verify that the email used in Stripe matches the one used for tracking
  4. Test the referral flow from start to finish

Next Steps

Tracking Setup

Learn more about tracking options and configuration.

View Guide
Webhooks

Understand how webhooks work with Refgrow.

View Guide
Dashboard Integration

Add the affiliate dashboard to your website.

View Guide
Tracking Webhooks