Dodo Payments

Dodo Payments 是一个全球 Merchant-of-Record 平台，它让 AI、SaaS 和数字业务能够在 150 多个国家销售，而无需处理税务、欺诈或合规问题。一个单一的、开发者友好的 API 驱动结账、计费和支付，因此您可以在几分钟内全球上线。

在 Dodo Payments 的 Discord 上获取支持

此插件由 Dodo Payments 团队维护。
有问题？我们的团队随时在 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("收到 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("收到 webhook:", payload.event_type);
  },
});

配置参考

插件选项

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

Checkout 插件选项

products：产品数组或返回产品的异步函数
successUrl：成功支付后重定向的 URL
authenticatedUsersOnly：要求用户身份验证（默认：false）

如果您遇到任何问题，请参考 Dodo Payments 文档中的故障排除步骤。

开始使用

概念

认证

数据库

集成

插件

指南

参考

在 Dodo Payments 的 Discord 上获取支持

开始使用 Dodo Payments

On this page