Skip to main content

Connect Stripe for Affiliate Tracking

Connect or reconnect Stripe in AffiliateBase, confirm the active connection, and prepare webhook-driven sale and commission attribution.

Table of Contents

Stripe connection is required for production attribution and billing lifecycle events.

Where To Connect

Use Setup step 1 in your dashboard.

What Happens

After connection, the app stores your Stripe account on the account and uses Stripe webhook processing for:

  • Invoice/payment success handling
  • Refund and dispute handling
  • Subscription state updates

If Stripe Is Already Connected

You can reconnect from setup if needed.

AffiliateBase shows whether the Stripe connection is in Live mode or Test mode. Stripe keeps these modes separate:

  • A live-mode connection attributes live payments.
  • A test-mode connection can attribute Stripe test payments.
  • Test payments received by a live-mode connection are recorded as test activity but do not create sales or commissions.

Common Checks

  • Account has a Stripe account ID
  • Stripe appears as Connected — Live mode or Connected — Test mode in settings
  • Webhook endpoint (/api/stripe/webhook) receives events without signature errors

When the Connection Needs Attention

In Settings → General, check the status in Stripe Connection:

  • Reconnect required: choose Reconnect Stripe and complete Stripe authorization. Your account and existing affiliate data are preserved.
  • Connection refresh pending or Connection temporarily unavailable: AffiliateBase will retry automatically. Contact support if the status persists.

If Stripe displays an error while reconnecting, send support the error text or a screenshot and explain which step failed. Do not include passwords or authentication codes.

Next steps