Skip to main content

​
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. We offer integrations with leading affiliate platforms including Affonso and Dub Partners to help you manage and track your affiliate programs seamlessly.

​
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 integrations with Affonso and Dub Partners, leading affiliate marketing platforms.

​
Integration Options

Dodo Payments integrates with two leading affiliate management platforms:
  • Affonso: A comprehensive affiliate management platform with automated commission tracking, real-time reporting, and dedicated affiliate dashboards.
  • Dub Partners: Use Dub’s link management and conversion tracking to power your affiliate program with detailed attribution analytics.
Choose the platform that best fits your needs, or use both for different use cases.

​
Affonso Integration

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
Your API key will be securely encrypted by Affonso.
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
This allows Affonso to securely verify incoming events from Dodo Payments.
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
Place this on all domains where users visit or convert (e.g. marketing site, app).
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
Best practice: Trigger this after successful registration or double opt-in (DOI).
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 protected]', 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}`;
For more details, see the Dodo Payments API documentation
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

​
Dub Partners Integration

You can also use Dub Partners to track affiliate referrals and conversions. Dub’s conversion tracking feature allows you to attribute sales to your affiliate links, providing detailed analytics on which partners drive the most revenue.
For detailed setup instructions, see our Dub integration guide which covers how to track sale conversion events and attribute revenue to your affiliate links.

​
Quick Setup with Dub Partners

  1. Enable conversion tracking in your Dub dashboard for affiliate links
  2. Capture the Dub click ID (dub_id cookie) when creating checkout sessions
  3. Store the click ID in payment metadata along with customer information
  4. Configure webhook integration to send sale data to Dub when payments succeed
The integration automatically tracks:
  • One-time payments
  • Subscription activations
  • Recurring subscription payments

Learn More

View the complete Dub integration guide with code examples and transformation templates.

​
Need Help?

If you face any issues or need support during integration:

Affonso Support

Dub Support

Dodo Payments Support

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

Integration Guides