Stripe Checkout API

Learn how to pass Affonso referral data to Stripe Checkout sessions for proper commission tracking.

Stripe Checkout API Integration

💡 Make sure your Stripe account is connected.

Pass the affonso_referral cookie as metadata to your Stripe Checkout session:

import { cookies } from 'next/headers';

// Get Affonso referral cookie (Next.js 15+)
// For Next.js 13-14: const cookieStore = cookies(); (without await)
const cookieStore = await cookies();
const affonsoReferral = cookieStore.get('affonso_referral')?.value || '';

// Add to your Stripe session
const session = await stripe.checkout.sessions.create({
  // ... your existing config
  metadata: {
    affonso_referral: affonsoReferral, // Add this line
  },
});

Testing

  1. Visit your site with ?atp=test (our test affiliate parameter)
  2. Check browser DevTools → Application → Cookies → look for affonso_referral
  3. Trigger your checkout flow locally
  4. Check your server logs/terminal - the Stripe session should show:
    metadata: { affonso_referral: "cmdhq6ayf..." }
  5. If the metadata appears in your logs, you're all set!

Note: Use 100% discount codes for live testing without payments, or test locally with server logs - Stripe test mode won't appear in Affonso.

Was this article helpful?