Dodo Payments

Dodo Payments 是一个全球商户记录平台，帮助 AI、SaaS 和数字业务在 150 多个国家销售产品，无需处理税务、欺诈或合规问题。一个简单且开发者友好的 API 支持结账、计费和付款，让您几分钟内即可全球上线。

本插件由 Dodo Payments 团队维护。如有 BUG、问题或功能请求，请访问 Dodo Payments GitHub 仓库。

在 Dodo Payments 的 Discord 获取支持

有疑问？我们的团队随时在 Discord 上为您提供帮助。

功能

注册时自动创建客户
具有产品 slug 映射的类型安全结账流程
自助客户门户
实时 Webhook 事件处理及签名验证

开始使用 Dodo Payments

您需要一个 Dodo Payments 账户和 API 密钥才能使用此集成。

安装

在项目根目录运行以下命令：

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

添加以下内容到您的 .env 文件：

DODO_PAYMENTS_API_KEY=your_api_key_here
DODO_PAYMENTS_WEBHOOK_SECRET=your_webhook_secret_here

创建或更新 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);
          },
        }),
      ],
    }),
  ],
});

将 environment 设置为 live_mode 即为生产环境。

创建或更新 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()],
});

使用

创建结账会话

const { data: checkout, error } = await authClient.dodopayments.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;
}

访问客户门户

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

列出客户数据

// 获取订阅
const { data: subscriptions, error } =
  await authClient.dodopayments.customer.subscriptions.list({
    query: {
      limit: 10,
      page: 1,
      active: true,
    },
  });

// 获取付款历史
const { data: payments, error } = await authClient.dodopayments.customer.payments.list({
  query: {
    limit: 10,
    page: 1,
    status: "succeeded",
  },
});

Webhooks

Webhooks 插件处理来自 Dodo Payments 的实时支付事件，具备安全的签名验证。默认端点为 /api/auth/dodopayments/webhooks。

在 Dodo Payments 控制台为您的端点 URL（如 https://your-domain.com/api/auth/dodopayments/webhooks）生成 webhook 密钥，并将其设置到您的 .env 文件：

DODO_PAYMENTS_WEBHOOK_SECRET=your_webhook_secret_here

示例处理器：

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

配置参考

插件选项

client（必填）：DodoPayments 客户端实例
createCustomerOnSignUp（可选）：用户注册时自动创建客户
use（必填）：启用的插件数组（checkout，portal，webhooks）

结账插件选项

products：产品数组或返回产品的异步函数
successUrl：付款成功后跳转的 URL
authenticatedUsersOnly：是否要求用户认证（默认：false）

如果遇到任何问题，请参考 Dodo Payments 文档进行排查。

Dodo Payments

在 Dodo Payments 的 Discord 获取支持

开始使用 Dodo Payments

本页目录