Dodo Payments Integration

Overview

Refgrow integrates with Dodo Payments to automatically track payments and calculate commissions for your affiliates.

• Automatic tracking of one-time payments and subscriptions
• Support for product-specific commission rates
• Support for affiliate-specific commission overrides
• Secure webhook implementation for real-time tracking
• Works with Dodo Payments' subscription management system

Setting Up Dodo Payments Integration

Step 1: Configure Webhook

1. Go to your project's "Integration" tab
2. Select "Dodo Payments" as your tracking method
3. Copy the provided webhook URL
4. In your Dodo Payments dashboard, go to Settings → Webhooks
5. Create a new webhook with the copied URL
6. Enable these events: payment.completed, subscription.created, subscription.renewed, subscription.updated, payment.refunded, subscription.canceled
7. Copy the webhook signing secret from Dodo Payments
8. Paste the signing secret in Refgrow and click "Save Secret"

Step 2: Choose Your User Flow

Select the appropriate user conversion flow for your business:

• Click → Signup → Purchase: Users create an account before purchasing
• Click → Purchase: Users can purchase directly without signing up first
• Both: Your platform supports both flows

Passing Referral Codes to Dodo Payments

For Dodo Payments

When creating a payment or subscription on your server, pass the referral code in the metadata:

// Example (Node.js Server-Side)
const refCode = req.cookies.refgrow_ref_code; // Get code from cookie

const payment = await dodo.payments.create({
  // ... other payment parameters
  metadata: {
    referral_code: refCode || null // Pass the code here
  }
});

For Dodo Payments Checkout

For checkout sessions, include the referral code in the metadata:

// Example (Node.js Server-Side)
const refCode = req.cookies.refgrow_ref_code; // Get code from cookie

const checkout = await dodo.checkout.create({
  // ... other checkout parameters
  metadata: {
    referral_code: refCode || null // Pass the code here
  }
});

Commission Configuration

Default Commission Settings

Configure your default commission structure in your project settings:

• Commission Type: Percentage or Fixed Amount
• Commission Value: The percentage or fixed amount
• Commission Duration: Lifetime, First Purchase, or Limited Period

Product-Specific Commissions

Override commission rates for specific products:

1. Go to your project's "Integration" tab
2. Scroll to "Product-Specific Commissions"
3. Click "Add Product Commission"
4. Select a Dodo Payments product and set its unique commission rate

Affiliate-Specific Overrides

Set custom commission rates for individual affiliates:

1. Go to your "Affiliates" tab
2. Find the affiliate you want to customize
3. Click "Manage Override"
4. Set a custom commission type and value

How It Works

Supported Webhook Events

Troubleshooting

API Reference

Webhook Endpoint

POST https://refgrow.com/webhook/dodo/{project-id}

Required Headers

Content-Type: application/json
dodo-signature: {hmac-sha256-signature}

Webhook Payload Example

{
  "type": "payment.completed",
  "data": {
    "payment": {
      "id": "pay_123456789",
      "amount": 2900,
      "currency": "USD",
      "discount_amount": 0,
      "tax_amount": 290
    },
    "customer": {
      "email": "customer@example.com"
    },
    "product": {
      "id": "prod_123456789"
    },
    "metadata": {
      "referral_code": "ABC123"
    },
    "discount": {
      "code": "SAVE10"
    }
  }
}

Best Practices

Need Help?

If you're experiencing issues with your Dodo Payments integration:

• Review your webhook delivery logs in your Dodo Payments dashboard
• Contact our support team with your project ID and specific error details