Skip to main content
AffiliateBase
Features Pricing Compare Help
Log in Start for free

Stripe Affiliate Integration Quickstart

Connect browser referrals to Stripe Checkout, verify payment attribution, and find the tracking script and REST API documentation.

Table of Contents

AffiliateBase is built around one launch path: connect Stripe, configure your account, create a campaign, install attribution, and verify attribution through a qualifying checkout.

Setup sequence

Complete these steps in order:

  1. Connect Stripe from setup.
  2. Configure account settings: display currency, payout method, and affiliate portal subdomain.
  3. Create the first campaign with destination URL, reward rules, payout threshold, and referral timing.
  4. Choose an install path for attribution: Stripe Payment Link, Buy Button or Pricing Table, custom Checkout Session, developer handoff, or promo codes only.
  5. Verify your chosen attribution path: a test affiliate click and Stripe client_reference_id for links, or a redeemed assigned promo code for code-only tracking.
  6. Invite or onboard affiliates and give them their referral link or promo code.
  7. Create payout runs once commissions become due, then execute or reconcile them based on the selected payout method.

For most Stripe Payment Link, Buy Button, or Pricing Table setups:

  1. Paste the AffiliateBase tracking script in the shared site layout or site-wide custom-code area, ideally before </body>.
  2. Keep the Stripe checkout link or element on the same published page as the script.
  3. Open the test affiliate link from AffiliateBase setup.
  4. Start a fresh Stripe checkout.
  5. Confirm the Checkout Session has client_reference_id.

For backend-created Checkout Sessions, submit referral_id from the browser first, then set Stripe client_reference_id server-side.

For promo-code-only launches, you have two options:

  • Campaign-generated codes: choose an available Stripe coupon during setup to use as the campaign discount default.
  • Individually assigned codes: open an affiliate and choose Manage promo codes to assign an existing Stripe promotion code or create one from an existing Stripe discount. No campaign discount default is required.

Both code paths work without a tracking script or client_reference_id handoff. See Assign Stripe Promo Codes to Affiliates for individual assignments and checkout verification.

What to verify

  • For link tracking, the test affiliate link creates a referral and Stripe receives its ID as client_reference_id.
  • For individual codes, Stripe actually redeems the assigned promotion code on a qualifying checkout after assignment.
  • A full test checkout creates the expected referral, sale, and commission records.
  • The affiliate portal shows referral links, promo code details when configured, commissions, and payout status.
  • PayPal and Wise payout runs use provider exports and external payment. Stripe Global Payouts beta execution is available only when AffiliateBase has enabled both onboarding and execution access, the merchant has acknowledged the beta, the Stripe connection is active, the source Financial Account is configured and funded, and the recipient is currently eligible. Recipient onboarding alone does not establish execution or paid status.

Next Steps