​
Introduction

This guide walks you through how to track affiliate referrals, handle commission events, and grow your revenue with trusted affiliate partnerships via Dodo Payments.

​
Key Features

Automated Commission Attribution

No spreadsheets or manual tracking. Referrals are automatically attributed and logged when a purchase is made.

Real-Time Reporting

Both you and your affiliates can monitor performance and leads from dedicated dashboards.

Flexible Tracking Options

Use tracking scripts, metadata fields, and webhook events to capture referral data across signups and transactions.

Fully Encrypted & Secure

All sensitive credentials and webhook data are securely exchanged and stored using best-in-class encryption.

Quick Setup

Launch your affiliate program in minutes—no code changes required beyond copy-pasting script snippets and API tokens.

Seamless Integration

Plug affiliate tracking directly into your checkout flows using our integration with Affonso, a leading affiliate marketing platform.

​
Integration Steps

We have partnered with Affonso, a leading affiliate management platform to power your sales. Follow the steps below to connect your Dodo Payments account with Affonso and begin tracking affiliate-driven sales.

1

Connect with Dodo Payments

To get started, connect your Dodo Payments account by adding your API key.

​
How to Get Your Dodo Payments API Key

  • Log in to your Dodo Payments Dashboard
  • Go to the Developer section in the left menu
  • Click on API Keys
  • Select Add API Key
  • Give it a name (e.g. “Affonso Integration”)
  • Click Create and copy your API key

​
Add Your API Key to Affonso

  • Open your Affonso Dashboard via affonso.io
  • Go to Program Details > Connect
  • Click the Dodo Payments integration card
  • Paste your Dodo Payments API key
  • Click Connect
2

Add Webhook to Dodo Payments

Once connected, you’ll receive a unique webhook URL from Affonso. This enables payment tracking and affiliate commission triggering.

​
Add Webhook URL in Dodo Payments

  • In your Dodo Payments Dashboard, go to Developer → Webhooks
  • Click Add Webhook
  • Paste your Affonso webhook URL (from your program settings)
  • Save the webhook

​
Add Webhook Secret in Affonso

  • After saving the webhook in Dodo Payments, copy the signing key provided
  • Paste it back into Affonso under the Dodo Payments webhook settings
3

Add the Tracking Script

Place the Affonso pixel on your site to start tracking affiliate visits and conversions.

<!-- Place in <head> tag -->
<script async defer
src="https://affonso.io/js/pixel.min.js"
data-affonso="YOUR_PUBLIC_PROGRAM_ID"
data-cookie_duration="YOUR_COOKIE_DURATION">
</script>

This script:

  • Tracks affiliate visits
  • Sets a cookie with the referral ID (affonso_referral)
  • Enables signup and payment tracking
4

Track User Signups

To gain funnel visibility and optimize affiliate performance, track user signups as leads.

// After successful registration
window.Affonso.signup(userEmail);

This will:

  • Log a new referral as a LEAD if the user came via an affiliate link
  • Display it in your dashboard and the affiliate’s stats
5

Pass Referral Data to Dodo Payments

To attribute commissions correctly, pass the referral ID from Affonso to Dodo Payments during checkout.

​
Payments Integration

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

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

async function main() {
  const payment = await client.payments.create({
    payment_link: true,
    billing: { city: 'city', country: 'AF', state: 'state', street: 'street', zipcode: 0 },
    customer: { email: 'email@email.com', name: 'name' },
    product_cart: [{ product_id: 'product_id', quantity: 0 }],
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(payment.payment_id);
}

main();

​
Subscription Integration

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

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

async function main() {
  const subscription = await client.subscriptions.create({
    billing: { city: 'city', country: 'IN', state: 'state', street: 'street', zipcode: 89789 },
    customer: { customer_id: 'customer_id' },
    product_id: 'product_id',
    payment_link: true,
    return_url: 'https://example.com/success',
    quantity: 1,
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(subscription.subscription_id);
}

main();

// Original Dodo Payments Link
const originalLink = 'https://checkout.dodopayments.com/buy/<YOUR_PRODUCT_ID>';

// Append referral ID as reference_id
const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
6

Testing Your Integration

Before launching publicly, test your setup with live affiliate links and test transactions.

Testing Checklist:

  • ✅ Create an affiliate and generate a tracking link
  • ✅ Visit your website via the affiliate link
  • ✅ Ensure the Affonso script loads and the affonso_referral cookie is set
  • ✅ Complete a signup (optional)
  • ✅ Complete a payment via Dodo Payments
  • ✅ Confirm tracking and attribution in your Affonso dashboard

​
Need Help?

If you face any issues or need support during integration:

Affonso Support

Dodo Payments Support

For Dodo Payments-specific API queries, refer to docs.dodopayments.com or contact our support team.