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 { createAuthClient } from "better-auth/react";
import { dodopaymentsClient } from "@dodopayments/better-auth";

export const authClient = createAuthClient({
  baseURL: process.env.BETTER_AUTH_URL || "http://localhost:3000",
  plugins: [dodopaymentsClient()],
});

使用

创建结账会话

const { data: checkoutSession, error } =
  await authClient.dodopayments.checkoutSession({
  slug: "premium-plan",
});

if (checkoutSession) {
  window.location.href = checkoutSession.url;
}

authClient.dodopayments.checkout() 已被弃用。新的集成请使用 authClient.dodopayments.checkoutSession()。

访问客户门户

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 的 Discord 上获取支持

开始使用 Dodo Payments

On this page