Chuyển đến nội dung chính
Trong hướng dẫn này, bạn sẽ học cách triển khai giá dựa trên số ghế bằng cách sử dụng các tiện ích bổ sung của Dodo Payments. Chúng tôi sẽ tạo một sản phẩm đăng ký với các tiện ích bổ sung cho các ghế bổ sung và chỉ cho bạn cách tạo liên kết thanh toán với số lượng tiện ích bổ sung tùy chỉnh.
Hướng dẫn này cung cấp mã triển khai mẫu cho một ứng dụng Node.js/Express. Bạn có thể chỉnh sửa mã này theo khung công tác cụ thể của mình (Next.js, React, Vue, v.v.) và tùy chỉnh giao diện người dùng theo nhu cầu ứng dụng của bạn.
Cuối cùng của hướng dẫn này, bạn sẽ biết cách:
  • Tạo các sản phẩm đăng ký với giá dựa trên số ghế
  • Thiết lập các tiện ích bổ sung cho các ghế bổ sung
  • Tạo liên kết thanh toán với số lượng tiện ích bổ sung tùy chỉnh
  • Xử lý các phiên thanh toán với số lượng ghế động

​
Những gì chúng ta đang xây dựng

Hãy tạo một mô hình giá dựa trên số ghế:
  • Gói cơ bản: 49 đô la/tháng cho tối đa 5 thành viên trong nhóm
  • Tiện ích bổ sung ghế: 2 đô la/tháng cho mỗi ghế bổ sung
  • Liên kết thanh toán: Thanh toán động với số lượng ghế tùy chỉnh
Trước khi bắt đầu, hãy đảm bảo bạn có:
  • Một tài khoản Dodo Payments
  • Sự quen thuộc cơ bản với TypeScript/Node.js

​
Bước 1: Tạo Tiện Ích Bổ Sung Ghế Của Bạn

Bây giờ chúng ta cần tạo một tiện ích bổ sung đại diện cho các ghế bổ sung. Tiện ích bổ sung này sẽ được gắn vào đăng ký cơ bản của chúng tôi và cho phép khách hàng mua thêm ghế.
Tạo sản phẩm đăng ký cơ bản
Những gì chúng ta đang xây dựng: Một add-on có giá 2 đô la mỗi tháng cho mỗi chỗ ngồi và có thể thêm vào bất kỳ gói đăng ký cơ bản nào.
1

Navigate to Add-Ons

  1. Trên bảng điều khiển Dodo Payments của bạn, ở lại phần Products
  2. Nhấp vào tab Add-Ons
  3. Nhấp Create Add-On
Điều này sẽ mở biểu mẫu tạo add-on.
2

Enter add-on details

Điền các giá trị sau cho add-on chỗ ngồi của chúng ta:Tên Add-On: Additional Team SeatMô tả: Add extra team members to your workspace with full access to all featuresGiá: Enter → 2.00Tiền tệ: Phải khớp với tiền tệ của đăng ký cơ bản của bạnDanh mục thuế: Chọn danh mục phù hợp cho sản phẩm của bạn.
3

Save your add-on

  1. Xem lại tất cả cài đặt của bạn:
    • Tên: Additional Team Seat
    • Giá: $2.00/month
  2. Nhấp Create Add-On
Add-on đã được tạo! Add-on chỗ ngồi của bạn giờ có thể được gắn vào các gói đăng ký.

​
Bước 2: Tạo Sản Phẩm Đăng Ký Cơ Bản Của Bạn

Chúng ta sẽ bắt đầu bằng cách tạo một sản phẩm đăng ký cơ bản bao gồm 5 thành viên trong nhóm. Đây sẽ là nền tảng cho mô hình giá dựa trên số ghế của chúng ta.
Tạo sản phẩm đăng ký cơ bản
1

Navigate to Products

  1. Đăng nhập vào bảng điều khiển Dodo Payments của bạn
  2. Nhấp vào Products trong thanh bên trái
  3. Nhấp vào nút Create Product
  4. Chọn Subscription làm loại sản phẩm
Bạn sẽ thấy một biểu mẫu nơi chúng ta sẽ cấu hình gói đăng ký cơ bản.
2

Fill in the subscription details

Bây giờ chúng ta sẽ nhập các chi tiết cụ thể cho gói cơ bản của mình:Tên sản phẩm: MotionMô tả: Where your team's documentation lives.Giá định kỳ: Enter → 49.00Chu kỳ thanh toán: Select → MonthlyĐơn vị tiền tệ: Chọn đơn vị bạn ưa thích (ví dụ, USD)

​
Bước 3: Kết Nối Tiện Ích Bổ Sung Với Đăng Ký

Bây giờ chúng ta cần liên kết tiện ích bổ sung ghế của mình với đăng ký cơ bản để khách hàng có thể mua thêm ghế trong quá trình thanh toán.
1

Attach the seat add-on

Gắn add-on vào đăng ký
  1. Cuộn xuống phần Tiện Ích Bổ Sung
  2. Nhấp Thêm Tiện Ích Bổ Sung
  3. Từ menu thả xuống, chọn tiện ích bổ sung ghế của bạn
  4. Xác nhận rằng nó xuất hiện trong cấu hình đăng ký của bạn
2

Save subscription changes

  1. Xem lại toàn bộ thiết lập đăng ký của bạn:
    • Gói cơ bản: $49/month cho 5 chỗ ngồi
    • Add-on: $2/month cho mỗi chỗ ngồi bổ sung
    • Dùng thử miễn phí: 14 ngày
  2. Nhấp Save Changes
Định giá theo chỗ ngồi đã được cấu hình! Khách hàng giờ có thể mua gói cơ bản và thêm chỗ ngồi tùy ý.

​
Bước 4: Tạo Liên Kết Thanh Toán Với Số Lượng Tiện Ích Bổ Sung Tùy Chỉnh

Bây giờ hãy tạo một ứng dụng Express.js để tạo liên kết thanh toán với số lượng tiện ích bổ sung tùy chỉnh. Đây là nơi sức mạnh thực sự của giá dựa trên số ghế xuất hiện - bạn có thể tạo các phiên thanh toán động với bất kỳ số lượng ghế bổ sung nào.
1

Set up your project

Tạo một dự án Node.js mới và cài đặt các phụ thuộc cần thiết:
mkdir seat-based-pricing
cd seat-based-pricing
npm init -y
npm install dodopayments express dotenv
npm install -D @types/node @types/express typescript ts-node
Tạo một file tsconfig.json:
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}
2

Create your environment file

Tạo một file .env với API key Dodo Payments của bạn:
DODO_PAYMENTS_API_KEY=your_actual_dodo_api_key_here
Không bao giờ commit API key của bạn vào hệ thống điều khiển phiên bản. Thêm .env vào file .gitignore của bạn.
3

Implement the checkout session creation

Tạo một file src/server.ts với mã sau:
// Add this new endpoint for dynamic seat quantities
import 'dotenv/config';
import DodoPayments from 'dodopayments';
import express, { Request, Response } from 'express';

const app = express();

// Initialize the Dodo Payments client
const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode'
});

async function createCheckoutSession(seatCount: number) {
  try {
    const session = await client.checkoutSessions.create({
      // Products to sell - use IDs from your Dodo Payments dashboard
      product_cart: [
        {
          product_id: 'pdt_7Rl9OWT2Mz4wwUTKz74iZ', // Replace with your actual product ID
          quantity: 1,
          addons: [
            {
              addon_id: 'adn_eKQbNakKrivDpaxmI8wKI', // Replace with your actual addon ID
              quantity: seatCount
            }
          ]
        }
      ],
      
      // Pre-fill customer information to reduce friction
      customer: {
        email: 'steve@example.com',
        name: 'Steve Irwin',
      },
      // Where to redirect after successful payment
      return_url: 'https://example.com/checkout/success',
    });

    // Redirect your customer to this URL to complete payment
    console.log('Checkout URL:', session.checkout_url);
    console.log('Session ID:', session.session_id);
    
    return session;
    
  } catch (error) {
    console.error('Failed to create checkout session:', error);
    throw error;
  }
}

// Example usage in an Express.js route
app.post('/create-checkout/:seatCount', async (req: Request, res: Response) => {
  try {
    const seatCount = parseInt(req.params.seatCount);
    const session = await createCheckoutSession(seatCount);
    res.json({ checkout_url: session.checkout_url });
  } catch (error) {
    res.status(500).json({ error: 'Failed to create checkout session' });
  }
});

// Add this line after your other middleware
app.use(express.static('public'));

// Add this route to serve the demo page
app.get('/', (req, res) => {
  res.sendFile(__dirname + '/../public/index.html');
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});
4

Add a simple web interface

Tạo một file public/index.html để dễ kiểm tra:
<!DOCTYPE html>
<html>
<head>
    <title>Seat-Based Pricing Demo</title>
    <style>
        body { font-family: Arial, sans-serif; max-width: 600px; margin: 50px auto; padding: 20px; }
        .form-group { margin: 20px 0; }
        label { display: block; margin-bottom: 5px; font-weight: bold; }
        input { width: 100%; padding: 10px; border: 1px solid #ddd; border-radius: 4px; }
        button { background: #007bff; color: white; padding: 10px 20px; border: none; border-radius: 4px; cursor: pointer; }
        button:hover { background: #0056b3; }
        .result { margin-top: 20px; padding: 15px; background: #f8f9fa; border-radius: 4px; }
    </style>
</head>
<body>
    <h1>Seat-Based Pricing Demo</h1>
    <p>Generate checkout links with custom seat quantities:</p>
    
    <div class="form-group">
        <label for="seatCount">Number of Additional Seats:</label>
        <input type="number" id="seatCount" value="3" min="0" max="50">
    </div>
    
    <button onclick="createCheckout()">Generate Checkout Link</button>
    
    <div id="result" class="result" style="display: none;">
        <h3>Checkout Link Generated!</h3>
        <p><strong>Seat Count:</strong> <span id="seatCountDisplay"></span></p>
        <p><strong>Total Cost:</strong> $<span id="totalCost"></span>/month</p>
        <p><strong>Checkout URL:</strong></p>
        <a id="checkoutUrl" href="#" target="_blank">Click here to checkout</a>
    </div>

    <script>
        async function createCheckout() {
            const seatCount = document.getElementById('seatCount').value;
            
            try {
                const response = await fetch(`/create-checkout/${seatCount}`, {
                    method: 'POST'
                });
                
                const data = await response.json();
                
                if (response.ok) {
                    document.getElementById('seatCountDisplay').textContent = seatCount;
                    document.getElementById('totalCost').textContent = data.total_cost;
                    document.getElementById('checkoutUrl').href = data.checkout_url;
                    document.getElementById('result').style.display = 'block';
                } else {
                    alert('Error: ' + data.error);
                }
            } catch (error) {
                alert('Error creating checkout session');
            }
        }
    </script>
</body>
</html>
Giao diện web đã được tạo! Bạn giờ có một giao diện đơn giản để thử các số lượng chỗ ngồi khác nhau.
5

Serve static files

Thêm đoạn này vào src/server.ts của bạn để phục vụ file HTML:
// Add this line after your other middleware
app.use(express.static('public'));

// Add this route to serve the demo page
app.get('/', (req, res) => {
  res.sendFile(__dirname + '/../public/index.html');
});
Các tệp tĩnh đã được cấu hình! Truy cập http://localhost:3000 để xem giao diện demo của bạn.

​
Bước 5: Kiểm Tra Triển Khai Của Bạn

Hãy kiểm tra triển khai giá dựa trên số ghế của chúng ta để đảm bảo mọi thứ hoạt động chính xác.
1

Start your server

  1. Đảm bảo bạn có file .env chứa API key chính xác
  2. Cập nhật ID sản phẩm và add-on trong mã của bạn bằng các giá trị thực từ bảng điều khiển Dodo Payments
  3. Khởi động server của bạn:
npm run dev
Server của bạn nên khởi động thành công và hiển thị “Server running on http://localhost:3000”
2

Test the web interface

Tạo sản phẩm đăng ký cơ bản
  1. Mở trình duyệt của bạn và truy cập http://localhost:3000
  2. Bạn sẽ thấy giao diện demo định giá theo chỗ ngồi
  3. Thử các số lượng chỗ ngồi khác nhau (0, 3, 10, v.v.)
  4. Nhấp “Generate Checkout Link” cho mỗi số lượng
  5. Xác nhận rằng các URL thanh toán được tạo đúng cách
3

Test a checkout session

  1. Tạo một liên kết thanh toán với 3 chỗ ngồi bổ sung
  2. Nhấp vào URL thanh toán để mở trang checkout của Dodo Payments
  3. Xác nhận rằng trang thanh toán hiển thị:
    • Gói cơ bản: $49/month
    • Chỗ ngồi bổ sung: 3 × 2 dollars = $6/month
  4. Hoàn tất mua hàng thử nghiệm
Trang thanh toán nên hiển thị chi tiết giá đúng và cho phép bạn hoàn tất giao dịch.
4

Listen for webhooks and update your DB

Để giữ cho cơ sở dữ liệu của bạn đồng bộ với các thay đổi đăng ký và chỗ ngồi, bạn cần lắng nghe các sự kiện webhook từ Dodo Payments. Webhook thông báo cho backend khi khách hàng hoàn tất thanh toán, cập nhật đăng ký hoặc thay đổi số lượng chỗ ngồi.Theo hướng dẫn webhook chính thức của Dodo Payments để có hướng dẫn từng bước về cách thiết lập các điểm cuối webhook và xử lý các sự kiện:

Dodo Payments Webhooks Documentation

Tìm hiểu cách nhận và xử lý an toàn các sự kiện webhook cho việc quản lý đăng ký và chỗ ngồi.

​
Khắc Phục Sự Cố

Các vấn đề phổ biến và giải pháp của chúng:
Nguyên nhân có thể:
  • ID sản phẩm hoặc ID add-on không hợp lệ
  • API key không có quyền hạn đầy đủ
  • Add-on chưa được liên kết đúng với đăng ký
  • Sự cố kết nối mạng
Giải pháp:
  1. Xác nhận ID sản phẩm và add-on tồn tại trong bảng điều khiển Dodo Payments
  2. Kiểm tra xem add-on đã được gắn đúng vào đăng ký chưa
  3. Đảm bảo API key có quyền tạo phiên thanh toán
  4. Kiểm tra kết nối API bằng một yêu cầu GET đơn giản

​
Chúc mừng! Bạn đã Triển Khai Giá Dựa Trên Số Ghế

Bạn đã thành công trong việc tạo một hệ thống giá dựa trên số ghế với Dodo Payments! Đây là những gì bạn đã hoàn thành:

Base Subscription

Đã tạo một sản phẩm đăng ký với 5 chỗ ngồi bao gồm và giá 49 đô la/tháng

Seat Add-ons

Đã cấu hình các add-on cho chỗ ngồi bổ sung với giá 2 đô la/tháng mỗi chỗ

Checkout

Đã xây dựng một API tạo các phiên thanh toán với số lượng chỗ ngồi tùy chỉnh

Web Interface

Đã tạo một giao diện web đơn giản để thử các số lượng chỗ ngồi khác nhau
Ví dụ này chỉ minh họa một triển khai tối thiểu của định giá theo chỗ ngồi. Để sử dụng trong môi trường sản xuất, bạn nên bổ sung xử lý lỗi chắc chắn, xác thực, kiểm tra dữ liệu, biện pháp bảo mật và điều chỉnh logic sao cho phù hợp với yêu cầu của ứng dụng.