动态定价结账与随意支付

Pay What You Want (PWYW) 允许您为单个产品提供可变定价，而无需创建多个产品条目。您可以在控制面板中设置最低价格，然后在创建结账会话时传递动态金额，或让客户自行选择价格。此方案适用于：

无需管理多个产品即可实现可变定价
由客户决定价格，让买家自行选择金额
通过 API 设置金额，以编程方式控制价格
适用于数字产品、捐赠或实验性发布的灵活定价模式

Pay What You Want 仅适用于一次性付款产品，不能与订阅一起使用。产品的基础货币必须为 USD、GBP 或 EUR。

前提条件

在控制面板中启用了 Pay What You Want 的一次性付款产品
产品 ID（例如 pdt_123abc456def）
从 Developer → API Keys 获取的 API 密钥

在产品上启用 Pay What You Want

在 Dodo Payments 控制面板中：

Go to Products

前往 Products，然后选择要配置的一次性付款产品。

Enable Pay What You Want

在 Pricing 部分开启 Pay What You Want。

Set the minimum price

输入客户必须支付的 Minimum Price。此项为必填项。

Set a suggested price (optional)

您可以选择设置 Suggested Price 以引导客户。系统没有最高价格设置。若要限制收费金额，请在创建会话前通过您自己的代码强制执行上限。

Save

点击 Update Product，并记下产品 ID，以便在结账会话中使用。

您可以在控制面板的 Products → View Details 下找到产品 ID，也可以使用 List Products API 获取。

使用固定金额创建结账会话

当您在产品购物车中传递 amount 时，只要该金额不低于产品的最低价格，结账就会使用该确切金额作为单价。 amount 字段使用货币的最小单位：USD 使用美分，GBP 使用便士，EUR 使用欧分。例如，1500 = $15.00 或 €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"
  }'

对于未启用 Pay What You Want 的产品，amount 字段会被忽略。该字段仅适用于一次性付款。

让客户自行选择价格

省略 amount 字段，即可在结账页面显示价格输入框。客户可以输入不低于产品最低价格的任意金额。

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"
  }'

使用动态金额的支付链接

Pay What You Want 产品的静态支付链接接受 paymentAmount 查询参数，用于固定收取的金额。与 Checkout Sessions API 不同，该参数使用主要货币单位（例如，12.5 表示 $12.50）。

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

paymentAmount 使用主要货币单位（15.00 表示 $15.00）。Checkout Sessions API 字段 product_cart[].amount 使用货币的最小单位（1500 表示 $15.00）。有关更多详细信息，请参阅 Integration Guide。

常见模式

按客户群体分层定价

使用同一个产品向不同类型的客户收取不同金额：

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 },
  });
}

基于数量的定价

根据购买数量调整单价。amount 是单件价格，总价为 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',
  });
}

促销定价

应用限时定价：

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',
    },
  });
}

使用 metadata 记录选择特定金额的原因（例如 pricing_tier、discount_code、user_segment）。这有助于您分析定价模式和客户行为。

验证金额

在创建结账会话前，检查金额是否不低于产品的最低价格。maxAmount 是您自己的业务上限；Dodo Payments 没有最高价格设置。

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",
    )

故障排除

Amount is being ignored

请确认：

产品已在控制面板中启用 Pay What You Want
产品是一次性付款产品，而不是订阅产品
金额格式正确（货币的最小单位：USD 使用美分，GBP 使用便士，EUR 使用欧分）

Amount is below the minimum price

如果金额低于产品的最低价格，API 会拒绝该结账会话。请在创建会话前验证金额，或省略 amount 字段，让客户自行选择。

Customer can't enter their own price

如果未显示价格输入框，请确保已从产品购物车中省略 amount 字段。当提供 amount 时，结账会使用该确切金额。

Checkout Sessions API

结账会话的完整 API 参考。

Checkout Sessions Guide

了解高级结账会话功能和自定义选项。

Pay What You Want Feature

详细了解 Pay What You Want 定价模式。

Integration Guides

Billing Deconstructions

Cookbooks

前提条件

在产品上启用 Pay What You Want

使用固定金额创建结账会话

让客户自行选择价格

使用动态金额的支付链接

常见模式

按客户群体分层定价

基于数量的定价

促销定价

验证金额

故障排除

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​前提条件

​在产品上启用 Pay What You Want

​使用固定金额创建结账会话

​让客户自行选择价格

​使用动态金额的支付链接

​常见模式

​按客户群体分层定价

​基于数量的定价

​促销定价

​验证金额

​故障排除

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

前提条件

在产品上启用 Pay What You Want

使用固定金额创建结账会话

让客户自行选择价格

使用动态金额的支付链接

常见模式

按客户群体分层定价

基于数量的定价

促销定价

验证金额

故障排除