Tổng quan về các bộ chuyển đổi Framework

Dodo Payments cung cấp các bộ chuyển đổi framework chính thức giúp đơn giản hóa việc tích hợp thanh toán. Mỗi bộ chuyển đổi được thiết kế để hoạt động liền mạch với các quy ước của framework của bạn, cung cấp chức năng thanh toán, cổng khách hàng và xử lý webhook ngay lập tức.

Các bộ chuyển đổi framework cho phép bạn tích hợp Dodo Payments trong dưới 10 dòng mã. Chúng tự động xử lý xác thực, phân tích yêu cầu và định dạng phản hồi.

Các bộ chuyển đổi Framework có sẵn

Chọn bộ chuyển đổi phù hợp với framework của bạn:

Next.js

Hỗ trợ App Router với các bộ xử lý tuyến đường cho thanh toán, cổng và webhook

Nuxt

Framework full-stack dựa trên Vue với tích hợp các tuyến đường máy chủ

Express

Các bộ xử lý dựa trên middleware cho framework Node.js phổ biến

Fastify

Framework Node.js hiệu suất cao với kiến trúc plugin

Hono

Framework web siêu nhanh cho edge, Cloudflare Workers và nhiều hơn nữa

Astro

Framework tập trung vào nội dung với hỗ trợ các điểm cuối máy chủ

SvelteKit

Framework Svelte full-stack với tích hợp các hook máy chủ

Remix

Framework React full-stack với các bộ xử lý loader và action

TanStack Start

Framework React full-stack an toàn kiểu với các chức năng máy chủ

Better Auth

Plugin framework xác thực cho xác thực + thanh toán liền mạch

Convex

Thành phần Backend-as-a-Service cho đồng bộ thanh toán theo thời gian thực

Tính năng chính

Tất cả các bộ chuyển đổi framework cung cấp những khả năng tích hợp sẵn này:

Tính năng	Mô tả
Bộ xử lý thanh toán	Hỗ trợ cho các luồng thanh toán tĩnh, động và dựa trên phiên
Cổng khách hàng	Bộ xử lý đã được xây dựng sẵn cho quản lý đăng ký và thanh toán
Bộ xử lý Webhook	Xác minh chữ ký an toàn với các bộ xử lý sự kiện kiểu
Cấu hình Môi trường	Thiết lập đơn giản qua các biến môi trường
An toàn kiểu	Hỗ trợ TypeScript đầy đủ với các payload kiểu

Bắt đầu nhanh

Bắt đầu với bất kỳ bộ chuyển đổi framework nào trong ba bước:

Cài đặt bộ chuyển đổi

Sử dụng trình quản lý gói của bạn để cài đặt bộ chuyển đổi cụ thể cho framework:

npm install @dodopayments/nextjs

npm install @dodopayments/nuxt

npm install @dodopayments/express

npm install @dodopayments/hono

npm install @dodopayments/astro

npm install @dodopayments/sveltekit

Cấu hình Biến môi trường

Thêm thông tin xác thực Dodo Payments của bạn vào môi trường:

DODO_PAYMENTS_API_KEY=your-api-key
DODO_PAYMENTS_WEBHOOK_KEY=your-webhook-secret
DODO_PAYMENTS_RETURN_URL=https://yourdomain.com/checkout/success
DODO_PAYMENTS_ENVIRONMENT="test_mode" # or "live_mode"

Không bao giờ cam kết tệp .env hoặc bí mật của bạn vào kiểm soát phiên bản.

Tạo Bộ xử lý tuyến đường

Thiết lập các tuyến đường thanh toán, cổng khách hàng và webhook của bạn:

Next.js
Express
Hono

// app/checkout/route.ts
import { Checkout } from "@dodopayments/nextjs";

export const GET = Checkout({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
});

import { checkoutHandler } from '@dodopayments/express';

app.get('/api/checkout', checkoutHandler({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
}));

import { Checkout } from "@dodopayments/hono";

app.get('/checkout', Checkout({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
}));

Bạn đã sẵn sàng để xử lý thanh toán! Truy cập các trang bộ chuyển đổi riêng lẻ để có hướng dẫn chi tiết và tất cả các tùy chọn có sẵn.

Các loại luồng thanh toán

Tất cả các bộ chuyển đổi hỗ trợ ba loại luồng thanh toán:

Thanh toán tĩnh (GET)

Sử dụng thanh toán tĩnh cho các liên kết thanh toán đơn giản, có thể chia sẻ. Truyền ID sản phẩm dưới dạng tham số truy vấn:

/api/checkout?productId=pdt_xxx&quantity=1

Hỗ trợ tùy chọn điền trước khách hàng và tùy chỉnh qua các tham số truy vấn.

Thanh toán động (POST)

Sử dụng thanh toán động để tạo thanh toán theo chương trình với các chi tiết tùy chỉnh:

{
  "product_id": "pdt_xxx",
  "customer": {
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "quantity": 1
}

Hỗ trợ cả thanh toán một lần và đăng ký.

Phiên thanh toán (POST)

Sử dụng phiên thanh toán cho trải nghiệm thanh toán linh hoạt nhất với hỗ trợ giỏ hàng:

{
  "product_cart": [
    { "product_id": "pdt_xxx", "quantity": 1 },
    { "product_id": "pdt_yyy", "quantity": 2 }
  ],
  "customer": {
    "email": "customer@example.com"
  }
}

Tìm hiểu thêm trong Hướng dẫn Phiên thanh toán.

Xử lý sự kiện Webhook

Tất cả các bộ chuyển đổi cung cấp xử lý webhook an toàn kiểu với các callback sự kiện chi tiết:

Webhooks({
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
  onPayload: async (payload) => {
    // Handle any webhook event
  },
  onPaymentSucceeded: async (payload) => {
    // Handle successful payments
  },
  onSubscriptionActive: async (payload) => {
    // Handle new subscriptions
  },
  // ... 20+ event types supported
});

Tất cả các bộ xử lý webhook tự động xác minh chữ ký và xác thực payload bằng cách sử dụng các schema Zod. Các yêu cầu không hợp lệ sẽ bị từ chối với mã lỗi thích hợp.

Chọn bộ chuyển đổi phù hợp

Framework	Tốt nhất cho	Runtime
Next.js	Ứng dụng React full-stack với App Router	Node.js, Edge
Nuxt	Ứng dụng Vue.js full-stack	Node.js
Express	REST APIs và ứng dụng Node.js truyền thống	Node.js
Fastify	APIs hiệu suất cao	Node.js
Hono	Triển khai Edge, Cloudflare Workers	Edge, Node.js
Astro	Các trang nội dung với các điểm cuối máy chủ	Node.js, Edge
SvelteKit	Ứng dụng Svelte full-stack	Node.js
Remix	React full-stack với định tuyến lồng nhau	Node.js
TanStack Start	React full-stack an toàn kiểu	Node.js
Better Auth	Ứng dụng đã sử dụng Better Auth	Nhiều loại
Convex	Ứng dụng sử dụng Convex cho backend	Convex Runtime

Nhận trợ giúp

Cần hỗ trợ với các bộ chuyển đổi framework?

Discord: Tham gia máy chủ cộng đồng của chúng tôi để được trợ giúp theo thời gian thực
Email: Liên hệ với chúng tôi qua support@dodopayments.com
GitHub: Mở một vấn đề trên kho lưu trữ bộ chuyển đổi tương ứng
Tài liệu: Truy cập tài liệu API

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Tổng quan về các bộ chuyển đổi Framework

Các bộ chuyển đổi Framework có sẵn

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Tính năng chính

Bắt đầu nhanh

Các loại luồng thanh toán

Xử lý sự kiện Webhook

Chọn bộ chuyển đổi phù hợp

Nhận trợ giúp

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

​Các bộ chuyển đổi Framework có sẵn

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

​Tính năng chính

​Bắt đầu nhanh

​Các loại luồng thanh toán

​Xử lý sự kiện Webhook

​Chọn bộ chuyển đổi phù hợp

​Nhận trợ giúp

Các bộ chuyển đổi Framework có sẵn

Tính năng chính

Bắt đầu nhanh

Các loại luồng thanh toán

Xử lý sự kiện Webhook

Chọn bộ chuyển đổi phù hợp

Nhận trợ giúp