Connecting Your Stripe Account

Step-by-step guide to connecting Stripe with AffiliateBase

Table of Contents

Connecting Your Stripe Account

AffiliateBase uses Stripe Connect to securely integrate with your payment system. This connection enables automatic conversion tracking, commission calculation, and affiliate payouts.

What You’ll Need

  • A Stripe account (create one free at stripe.com)
  • Admin access to your Stripe dashboard

Connection Steps

1. Start the Connection

From your AffiliateBase dashboard:

  1. Go to Settings → General
  2. Click Connect Stripe (or reconnect if updating)
  3. You’ll be redirected to Stripe’s authorization page

2. Authorize Access

On the Stripe authorization page:

  1. Log in to your Stripe account
  2. Review the permissions AffiliateBase is requesting
  3. Click Connect to authorize

3. Automatic Webhook Setup

Once connected, AffiliateBase automatically:

  • Creates webhook endpoints in your Stripe account
  • Configures event listeners for payment events
  • Validates the connection is working

No manual webhook configuration required.

Permissions Explained

AffiliateBase requests these Stripe permissions:

PermissionPurpose
Read paymentsTrack conversions from completed payments
Read customersMatch conversions to affiliate referrals
Read subscriptionsTrack recurring revenue for commissions
Read invoicesCalculate accurate commission amounts

We never modify your Stripe data or access sensitive financial information.

Verifying Your Connection

After connecting, verify the integration:

  1. Go to Settings → General
  2. Look for the green “Connected” status next to Stripe
  3. Your Stripe account name should be displayed

You can also check in Stripe:

  1. Go to your Stripe Dashboard
  2. Navigate to Developers → Webhooks
  3. Look for the AffiliateBase webhook endpoint

Troubleshooting Connection Issues

”Connection validation failed”

This usually means the OAuth token expired. To fix:

  1. Go to Settings → General
  2. Click Reconnect Stripe
  3. Complete the authorization flow again

”Webhook not receiving events”

If conversions aren’t tracking:

  1. Check your Stripe webhook dashboard for failed deliveries
  2. Verify your site is accessible (not behind authentication)
  3. Contact support if issues persist

”Access denied” during authorization

Ensure you’re logging into the correct Stripe account. If you manage multiple accounts:

  1. Log out of Stripe completely
  2. Start the connection process again
  3. Log into the correct account

Disconnecting Stripe

If you need to disconnect:

  1. Go to Settings → General
  2. Click Disconnect Stripe
  3. Confirm the disconnection

Note: Disconnecting will stop conversion tracking and prevent payouts until you reconnect.

Security

Your Stripe connection is secured by:

  • OAuth 2.0 authentication (we never see your Stripe password)
  • Encrypted token storage
  • Automatic token refresh
  • Webhook signature verification

Next Steps

With Stripe connected, you’re ready to: