Documentation

Technical Implementation

Everything you need to know about setting up commissions, payouts, and custom integrations.

1

Configure your program

Define your commission rates, payout thresholds, and cookie duration in the program settings.

2

Install the tracking script

Add our lightweight tracking script to your website to record clicks and attribute conversions to your affiliates.

3

Invite your affiliates

Share your sign-up page link or manually add affiliates to your program. They will get access to their personal dashboard.

4

Approve conversions

Review and approve recorded conversions. Once approved, commissions will be calculated and scheduled for payout.

Commission Structure

AffiliateBloom supports highly flexible commission models. You can reward partners for sign-ups, sales, or recurring subscriptions.

Supported Models

Flat Fee$50 per referral
Percentage20% of sale value
RecurringLifetime or limited
TieredPerformance-based rates
commission_config.json
// Example: Dynamic Commission Logic
const commission = {
  type: 'PERCENTAGE', // or 'FLAT'
  value: 20, // 20%
  recurring: true,
  recurring_duration: 12, // months
  cookie_duration: 60, // days
  tiers: [
    { threshold: 1000, rate: 25 }, // 25% after $1k revenue
    { threshold: 5000, rate: 30 }  // 30% after $5k revenue
  ]
};

Payment Methods

Automate your global payouts with built-in integrations for the world's leading payment platforms.

💳

Stripe Connect

Direct bank payouts in 40+ countries.

💰

PayPal Payouts

Instant global payments via email.

🌍

Wise (TransferWise)

Low-fee international bank transfers.

payout_setup.ts
// Payout Method Configuration
const payoutSetup = {
  method: 'STRIPE_CONNECT', // or 'PAYPAL', 'WISE', 'BANK_TRANSFER'
  minimum_payout: 50.00,
  schedule: 'MONTHLY', // 'WEEKLY' or 'MANUAL'
  currency: 'USD',
  auto_payout: true
};

Installation

Add to your <head> tag

<script
  defer
  data-program="YOUR_PROGRAM_ID"
  src="https://cdn.stackbloom.io/ab.js"
></script>

Replace YOUR_PROGRAM_ID with your actual program ID from the dashboard.

Stripe

Connect your Stripe account in the "Integrations" tab. We will automatically track successful payments and create corresponding referrals.

Shopify

Install the AffiliateBloom app from the Shopify App Store. We will handle script installation and order synchronization automatically.

WooCommerce

Download and install our WordPress plugin. Enter your API key in the settings to start syncing orders and customers.

Next.js / Custom

Use our React SDK or directly call our API to record conversions. Ideal for custom checkout flows and SaaS platforms.

Developer API

Use our REST API to build custom integrations, automate payouts, or sync data with your internal tools.

// Record a conversion via API
const response = await fetch('https://api.stackbloom.io/v1/conversions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    referral_code: 'REF_123',
    amount: 100.00,
    order_id: 'order_abc_123',
    customer_email: 'customer@example.com'
  })
});

Need more help?

Our support team is available 24/7 to help you with your integration.