Dodo Payments

Dodo Payments is a global Merchant-of-Record platform that lets AI, SaaS and digital businesses sell in 150+ countries without touching tax, fraud, or compliance. A single, developer-friendly API powers checkout, billing, and payouts so you can launch worldwide in minutes.

Get support on Dodo Payments' Discord

This plugin is maintained by the Dodo Payments team.
Have questions? Our team is available on Discord to assist you anytime.

Features

Automatic customer creation on sign-up
Type-safe checkout flows with product slug mapping
Self-service customer portal
Real-time webhook event processing with signature verification

Get started with Dodo Payments

You need a Dodo Payments account and API keys to use this integration.

Installation

Run the following command in your project root:

npm install @dodopayments/better-auth dodopayments better-auth zod

Add these to your .env file:

DODO_PAYMENTS_API_KEY=your_api_key_here
DODO_PAYMENTS_WEBHOOK_SECRET=your_webhook_secret_here

Create or update src/lib/auth.ts:

import { betterAuth } from "better-auth";
import {
  dodopayments,
  checkout,
  portal,
  webhooks,
} from "@dodopayments/better-auth";
import DodoPayments from "dodopayments";
 
export const dodoPayments = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY!,
  environment: "test_mode"
});
 
export const auth = betterAuth({
  plugins: [
    dodopayments({
      client: dodoPayments,
      createCustomerOnSignUp: true,
      use: [
        checkout({
          products: [
            {
              productId: "pdt_xxxxxxxxxxxxxxxxxxxxx",
              slug: "premium-plan",
            },
          ],
          successUrl: "/dashboard/success",
          authenticatedUsersOnly: true,
        }),
        portal(),
        webhooks({
          webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_SECRET!,
          onPayload: async (payload) => {
            console.log("Received webhook:", payload.event_type);
          },
        }),
      ],
    }),
  ],
});

Set environment to live_mode for production.

Create or update src/lib/auth-client.ts:

import { dodopaymentsClient } from "@dodopayments/better-auth";
 
export const authClient = createAuthClient({
  baseURL: process.env.BETTER_AUTH_URL || "http://localhost:3000",
  plugins: [dodopaymentsClient()],
});

Usage

Creating a Checkout Session

const { data: checkout, error } = await authClient.checkout({
  slug: "premium-plan",
  customer: {
    email: "customer@example.com",
    name: "John Doe",
  },
  billing: {
    city: "San Francisco",
    country: "US",
    state: "CA",
    street: "123 Market St",
    zipcode: "94103",
  },
  referenceId: "order_123",
});
 
if (checkout) {
  window.location.href = checkout.url;
}

Accessing the Customer Portal

const { data: customerPortal, error } = await authClient.customer.portal();
if (customerPortal && customerPortal.redirect) {
  window.location.href = customerPortal.url;
}

Listing Customer Data

// Get subscriptions
const { data: subscriptions, error } =
  await authClient.customer.subscriptions.list({
    query: {
      limit: 10,
      page: 1,
      active: true,
    },
  });
 
// Get payment history
const { data: payments, error } = await authClient.customer.payments.list({
  query: {
    limit: 10,
    page: 1,
    status: "succeeded",
  },
});

Webhooks

The webhooks plugin processes real-time payment events from Dodo Payments with secure signature verification. The default endpoint is /api/auth/webhooks/dodopayments.

Generate a webhook secret for your endpoint URL (e.g., https://your-domain.com/api/auth/webhooks/dodopayments) in the Dodo Payments Dashboard and set it in your .env file:

DODO_PAYMENTS_WEBHOOK_SECRET=your_webhook_secret_here

Example handler:

webhooks({
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_SECRET!,
  onPayload: async (payload) => {
    console.log("Received webhook:", payload.event_type);
  },
});