Thanh Toán Giá Động với Pay What You Want

Pay What You Want (PWYW) cho phép bạn cung cấp mức giá biến đổi cho một sản phẩm duy nhất mà không cần tạo nhiều mục sản phẩm. Bạn đặt mức giá tối thiểu trong dashboard, sau đó truyền số tiền động khi tạo checkout session hoặc cho phép khách hàng tự chọn mức giá. Phương pháp này phù hợp với:

Định giá biến đổi mà không cần quản lý nhiều sản phẩm
Định giá do khách hàng quyết định, trong đó người mua tự chọn số tiền
Kiểm soát giá theo chương trình, trong đó bạn thiết lập số tiền qua API
Các mô hình định giá linh hoạt cho sản phẩm kỹ thuật số, khoản quyên góp hoặc các đợt ra mắt thử nghiệm

Pay What You Want chỉ khả dụng cho các sản phẩm thanh toán một lần. Tính năng này không thể được sử dụng với subscriptions. Loại tiền tệ cơ sở của sản phẩm phải là USD, GBP hoặc EUR.

Điều kiện tiên quyết

Một sản phẩm thanh toán một lần đã bật Pay What You Want trong dashboard
ID sản phẩm (ví dụ: pdt_123abc456def)
API key từ Developer → API Keys

Bật Pay What You Want cho sản phẩm

Trong dashboard Dodo Payments:

Go to Products

Đi đến Products và chọn sản phẩm thanh toán một lần bạn muốn cấu hình.

Enable Pay What You Want

Trong phần Pricing, bật Pay What You Want.

Set the minimum price

Nhập Minimum Price mà khách hàng phải thanh toán. Đây là thông tin bắt buộc.

Set a suggested price (optional)

Bạn có thể tùy chọn đặt Suggested Price để định hướng cho khách hàng. Không có tùy chọn đặt mức giá tối đa. Để giới hạn số tiền bạn thu, hãy áp dụng giới hạn trong code của riêng bạn trước khi tạo session.

Save

Nhấp vào Update Product và ghi lại product ID để sử dụng trong checkout session.

Bạn có thể tìm product ID trong dashboard tại Products → View Details hoặc sử dụng List Products API.

Tạo Checkout Session với số tiền cố định

Khi bạn truyền amount trong product cart, checkout sẽ sử dụng chính xác số tiền đó làm đơn giá, miễn là số tiền này bằng hoặc cao hơn mức giá tối thiểu của sản phẩm. Trường amount sử dụng đơn vị tiền tệ nhỏ nhất: cents cho USD, pence cho GBP, cents cho EUR. Ví dụ, 1500 = $15.00 hoặc €15.00.

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123abc456def',
      quantity: 1,
      amount: 1500, // $15.00 in cents
    }
  ],
  return_url: 'https://yoursite.com/success',
  metadata: {
    pricing_tier: 'custom'
  }
});

console.log('Checkout URL:', session.checkout_url);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
)

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123abc456def",
            "quantity": 1,
            "amount": 1500,  # $15.00 in cents
        }
    ],
    return_url="https://yoursite.com/success",
    metadata={
        "pricing_tier": "custom"
    }
)

print(f"Checkout URL: {session.checkout_url}")

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123abc456def",
        "quantity": 1,
        "amount": 1500
      }
    ],
    "return_url": "https://yoursite.com/success"
  }'

Trường amount bị bỏ qua đối với các sản phẩm chưa bật Pay What You Want. Trường này chỉ áp dụng cho các khoản thanh toán một lần.

Cho phép khách hàng tự chọn mức giá

Bỏ qua trường amount để hiển thị ô nhập giá trên checkout. Khách hàng có thể nhập bất kỳ số tiền nào bằng hoặc cao hơn mức giá tối thiểu của sản phẩm.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123abc456def',
      quantity: 1,
      // No amount field — customer chooses
    }
  ],
  return_url: 'https://yoursite.com/success',
});

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123abc456def",
            "quantity": 1,
            # No amount field — customer chooses
        }
    ],
    return_url="https://yoursite.com/success",
)

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123abc456def",
        "quantity": 1
      }
    ],
    "return_url": "https://yoursite.com/success"
  }'

Sử dụng Payment Links với số tiền động

Các payment link tĩnh dành cho sản phẩm Pay What You Want chấp nhận query parameter paymentAmount để cố định số tiền được tính. Không giống Checkout Sessions API, parameter này sử dụng đơn vị tiền tệ lớn (ví dụ: 12.5 cho $12.50).

https://checkout.dodopayments.com/buy/pdt_123abc456def?paymentAmount=15.00

paymentAmount sử dụng đơn vị tiền tệ lớn (15.00 là $15.00). Trường product_cart[].amount của Checkout Sessions API sử dụng đơn vị tiền tệ nhỏ nhất (1500 là $15.00). Xem Integration Guide để biết thêm chi tiết.

Các mẫu thường gặp

Định giá theo cấp dựa trên phân khúc khách hàng

Tính các mức tiền khác nhau cho các loại khách hàng khác nhau bằng cùng một sản phẩm:

async function createCheckoutForSegment(segment: string) {
  const amounts: Record<string, number> = {
    student: 1000,    // $10.00
    regular: 2500,    // $25.00
    premium: 5000,    // $50.00
  };

  return client.checkoutSessions.create({
    product_cart: [
      {
        product_id: 'pdt_123abc456def',
        quantity: 1,
        amount: amounts[segment],
      }
    ],
    return_url: 'https://yoursite.com/success',
    metadata: { segment },
  });
}

Định giá dựa trên số lượng

Điều chỉnh đơn giá dựa trên số lượng đã mua. amount là giá cho mỗi đơn vị và tổng số tiền là amount × quantity:

async function createCheckoutWithQuantity(quantity: number) {
  const basePrice = 2000; // $20.00 per unit
  let discount = 0;

  if (quantity >= 5) {
    discount = 0.20; // 20% off
  } else if (quantity >= 2) {
    discount = 0.10; // 10% off
  }

  const unitAmount = Math.round(basePrice * (1 - discount));

  return client.checkoutSessions.create({
    product_cart: [
      {
        product_id: 'pdt_123abc456def',
        quantity,
        amount: unitAmount, // Charged per unit
      }
    ],
    return_url: 'https://yoursite.com/success',
  });
}

Định giá khuyến mãi

Áp dụng mức giá có thời hạn:

async function createCheckoutWithPromo() {
  const isPromoActive = checkIfPromotionActive(); // Your logic
  const regularPrice = 3000; // $30.00
  const promoPrice = 2000;   // $20.00

  return client.checkoutSessions.create({
    product_cart: [
      {
        product_id: 'pdt_123abc456def',
        quantity: 1,
        amount: isPromoActive ? promoPrice : regularPrice,
      }
    ],
    return_url: 'https://yoursite.com/success',
    metadata: {
      pricing_type: isPromoActive ? 'promotional' : 'regular',
    },
  });
}

Sử dụng metadata để theo dõi lý do các số tiền cụ thể được lựa chọn (ví dụ: pricing_tier, discount_code, user_segment). Điều này giúp bạn phân tích các mô hình định giá và hành vi của khách hàng.

Xác thực số tiền

Kiểm tra để đảm bảo số tiền bằng hoặc cao hơn mức giá tối thiểu của sản phẩm trước khi tạo checkout session. maxAmount là giới hạn kinh doanh do bạn tự đặt; Dodo Payments không có tùy chọn đặt mức giá tối đa.

async function createValidatedCheckout(
  productId: string,
  amountInCents: number,
  minAmount: number,
  maxAmount: number | null
) {
  if (amountInCents < minAmount) {
    throw new Error(
      `Amount ${amountInCents} is below minimum ${minAmount}`
    );
  }

  if (maxAmount !== null && amountInCents > maxAmount) {
    throw new Error(
      `Amount ${amountInCents} exceeds maximum ${maxAmount}`
    );
  }

  return client.checkoutSessions.create({
    product_cart: [
      {
        product_id: productId,
        quantity: 1,
        amount: amountInCents,
      }
    ],
    return_url: 'https://yoursite.com/success',
  });
}

def create_validated_checkout(
    product_id: str,
    amount_in_cents: int,
    min_amount: int,
    max_amount: int | None
):
    if amount_in_cents < min_amount:
        raise ValueError(
            f"Amount {amount_in_cents} is below minimum {min_amount}"
        )

    if max_amount is not None and amount_in_cents > max_amount:
        raise ValueError(
            f"Amount {amount_in_cents} exceeds maximum {max_amount}"
        )

    return client.checkout_sessions.create(
        product_cart=[
            {
                "product_id": product_id,
                "quantity": 1,
                "amount": amount_in_cents,
            }
        ],
        return_url="https://yoursite.com/success",
    )

Xử lý sự cố

Amount is being ignored

Xác minh rằng:

Sản phẩm đã bật Pay What You Want trong dashboard
Sản phẩm là sản phẩm thanh toán một lần, không phải subscription
Số tiền có đúng định dạng (đơn vị tiền tệ nhỏ nhất: cents cho USD, pence cho GBP, cents cho EUR)

Amount is below the minimum price

API từ chối các checkout session có số tiền thấp hơn mức giá tối thiểu của sản phẩm. Hãy xác thực số tiền trước khi tạo session hoặc bỏ qua trường amount để cho phép khách hàng tự chọn.

Customer can't enter their own price

Nếu ô nhập giá không xuất hiện, hãy đảm bảo bạn đã bỏ trường amount khỏi product cart. Khi amount được cung cấp, checkout sẽ sử dụng chính xác số tiền đó.

Checkout Sessions API

Tài liệu tham chiếu API đầy đủ cho checkout session.

Checkout Sessions Guide

Khám phá các tính năng nâng cao và tùy chọn tùy chỉnh của checkout session.

Pay What You Want Feature

Tìm hiểu thêm về mô hình định giá Pay What You Want.

Integration Guides

Billing Deconstructions

Cookbooks

Thanh Toán Giá Động với Pay What You Want

Điều kiện tiên quyết

Bật Pay What You Want cho sản phẩm

Tạo Checkout Session với số tiền cố định

Cho phép khách hàng tự chọn mức giá

Sử dụng Payment Links với số tiền động

Các mẫu thường gặp

Định giá theo cấp dựa trên phân khúc khách hàng

Định giá dựa trên số lượng

Định giá khuyến mãi

Xác thực số tiền

Xử lý sự cố

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​Điều kiện tiên quyết

​Bật Pay What You Want cho sản phẩm

​Tạo Checkout Session với số tiền cố định

​Cho phép khách hàng tự chọn mức giá

​Sử dụng Payment Links với số tiền động

​Các mẫu thường gặp

​Định giá theo cấp dựa trên phân khúc khách hàng

​Định giá dựa trên số lượng

​Định giá khuyến mãi

​Xác thực số tiền

​Xử lý sự cố

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

Điều kiện tiên quyết

Bật Pay What You Want cho sản phẩm

Tạo Checkout Session với số tiền cố định

Cho phép khách hàng tự chọn mức giá

Sử dụng Payment Links với số tiền động

Các mẫu thường gặp

Định giá theo cấp dựa trên phân khúc khách hàng

Định giá dựa trên số lượng

Định giá khuyến mãi

Xác thực số tiền

Xử lý sự cố