Stripe Checkout

For sites using Stripe Checkout with a custom backend.

When to Use This

Use this method if you:

Create Checkout sessions server-side
Redirect customers to Stripe-hosted checkout
Use stripe.checkout.sessions.create()

Step 1: Install Tracking Script

Add to all pages of your frontend:

<script src="https://api.promoteboost.com/tracker.js" data-org="YOUR_ORG_ID"></script>

Find your Org ID in Settings → Integration.

Step 2: Get Referral on Frontend

Before redirecting to checkout, capture the referral:

const referralId = window.promoteboost_referral || '';

Step 3: Send to Your Backend

Include the referral when creating the checkout session:

const response = await fetch('/api/create-checkout', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    priceId: 'price_xxx',
    referralId: referralId,
  }),
});

const { url } = await response.json();
window.location.href = url;

Step 4: Add to Stripe Checkout

In your backend, add the referral to the session metadata:

Node.js

app.post('/api/create-checkout', async (req, res) => {
  const { priceId, referralId } = req.body;

  const session = await stripe.checkout.sessions.create({
    mode: 'subscription', // or 'payment'
    line_items: [{ price: priceId, quantity: 1 }],
    success_url: 'https://yoursite.com/success',
    cancel_url: 'https://yoursite.com/cancel',
    metadata: {
      promoteboost_referral: referralId || '',
    },
  });

  res.json({ url: session.url });
});

Python (Flask)

@app.route('/api/create-checkout', methods=['POST'])
def create_checkout():
    data = request.get_json()

    session = stripe.checkout.Session.create(
        mode='subscription',
        line_items=[{'price': data['priceId'], 'quantity': 1}],
        success_url='https://yoursite.com/success',
        cancel_url='https://yoursite.com/cancel',
        metadata={
            'promoteboost_referral': data.get('referralId', ''),
        },
    )

    return jsonify({'url': session.url})

PHP

$session = \Stripe\Checkout\Session::create([
  'mode' => 'subscription',
  'line_items' => [[
    'price' => $priceId,
    'quantity' => 1,
  ]],
  'success_url' => 'https://yoursite.com/success',
  'cancel_url' => 'https://yoursite.com/cancel',
  'metadata' => [
    'promoteboost_referral' => $referralId ?? '',
  ],
]);

For Subscriptions: Add to Customer

To track recurring payments, also add metadata to the customer:

const session = await stripe.checkout.sessions.create({
  mode: 'subscription',
  customer_creation: 'always',
  line_items: [{ price: priceId, quantity: 1 }],
  success_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel',
  metadata: {
    promoteboost_referral: referralId,
  },
  subscription_data: {
    metadata: {
      promoteboost_referral: referralId,
    },
  },
});

Complete Frontend Example

<!DOCTYPE html>
<html>
<head>
  <script src="https://api.promoteboost.com/tracker.js" data-org="YOUR_ORG_ID"></script>
</head>
<body>
  <button id="checkout-btn">Subscribe Now</button>

  <script>
    document.getElementById('checkout-btn').addEventListener('click', async () => {
      const referralId = window.promoteboost_referral || '';

      const response = await fetch('/api/create-checkout', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          priceId: 'price_xxx',
          referralId: referralId,
        }),
      });

      const { url } = await response.json();
      window.location.href = url;
    });
  </script>
</body>
</html>

Done!

When a customer completes checkout:

Stripe sends a webhook to PromoteBoost
We read the promoteboost_referral from metadata
Sale is attributed to the affiliate
Commission is calculated

Test with Stripe test mode before going live.

PreviousOverview NextStripe API

Last updated 2 hours ago