Dodo Payments Checkout API

Dodo Payments Checkout API Integration

💡 Make sure your Dodo Payments account is connected.

Pass the affonso_referral cookie as metadata to your Dodo Payments:

import { cookies } from 'next/headers';
import DodoPayments from 'dodopayments';

// 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 || '';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
});

// For payments
const payment = await client.payments.create({
  // ... your existing config
  metadata: {
    affonso_referral: affonsoReferral, // Add this line
  },
});

// For subscriptions
const subscription = await client.subscriptions.create({
  // ... your existing config
  metadata: {
    affonso_referral: affonsoReferral, // Add this line
  },
});

Testing

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