好きな金額で支払うダイナミックプライシングチェックアウト

Pay What You Want (PWYW) を使用すると、複数の商品エントリを作成せずに、1 つの商品に変動価格を設定できます。ダッシュボードで最低価格を設定し、checkout sessions の作成時に動的な金額を渡すか、顧客が価格を選択できるようにします。この方法は、次の用途に適しています:

複数の商品を管理せずに変動価格を設定する
購入者が金額を選択する、顧客主導の価格設定
API 経由で金額を設定する、プログラムによる価格管理
デジタル商品、寄付、実験的なローンチ向けの柔軟な価格モデル

Pay What You Want は、one-time payment products でのみ利用できます。subscriptions では使用できません。商品の base currency は USD、GBP、または EUR である必要があります。

前提条件

ダッシュボードで Pay What You Want が有効になっている one-time payment product
商品 ID（例: pdt_123abc456def）
Developer → API Keys から取得した API key

商品で Pay What You Want を有効にする

Dodo Payments ダッシュボードで:

Go to Products

Products に移動し、設定する one-time payment product を選択します。

Enable Pay What You Want

Pricing セクションで Pay What You Want をオンに切り替えます。

Set the minimum price

顧客が支払う必要のある Minimum Price を入力します。これは必須です。

Set a suggested price (optional)

必要に応じて、顧客の参考となる Suggested Price を設定します。上限価格の設定はありません。請求額に上限を設けるには、session を作成する前に独自のコードで上限を適用してください。

Save

Update Product をクリックし、checkout sessions で使用する商品 ID を控えます。

商品 ID は、ダッシュボードの Products → View Details で確認できます。または、List Products API を使用してください。

固定金額で Checkout Session を作成する

商品 cart に amount を渡すと、商品の最低価格以上である限り、checkout ではその金額が unit price としてそのまま使用されます。 amount フィールドでは、通貨の最小単位を使用します。USD は cents、GBP は pence、EUR は cents です。たとえば、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 フィールドは無視されます。これは one-time payments にのみ適用されます。

顧客が価格を選択できるようにする

amount フィールドを省略すると、checkout に価格入力欄が表示されます。顧客は、商品の最低価格以上の任意の金額を入力できます。

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

動的な金額で Payment Links を使用する

Pay What You Want 商品の static payment links は、請求額を固定する paymentAmount query parameter を受け付けます。Checkout Sessions API とは異なり、この parameter では主要通貨単位を使用します（例: $12.50 の場合は 12.5）。

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

数量ベースの価格設定

購入数量に応じて unit price を調整します。amount は unit ごとの価格で、合計は 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）。これにより、価格設定のパターンと顧客行動を分析できます。

金額を検証する

checkout session を作成する前に、金額が商品の最低価格以上であることを確認してください。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 が有効になっている
商品が subscription ではなく、one-time payment product である
金額の形式が正しい（通貨の最小単位: USD は cents、GBP は pence、EUR は cents）

Amount is below the minimum price

API は、金額が商品の最低価格を下回る checkout sessions を拒否します。session を作成する前に金額を検証するか、amount フィールドを省略して顧客が選択できるようにしてください。

Customer can't enter their own price

価格入力欄が表示されない場合は、商品 cart から amount フィールドを省略していることを確認してください。amount が指定されている場合、checkout ではその金額がそのまま使用されます。

Checkout Sessions API

checkout sessions の完全な API reference です。

Checkout Sessions Guide

高度な checkout session 機能とカスタマイズオプションをご覧ください。

Pay What You Want Feature

Pay What You Want pricing model の詳細をご覧ください。

Integration Guides

Billing Deconstructions

Cookbooks

好きな金額で支払うダイナミックプライシングチェックアウト

前提条件

商品で Pay What You Want を有効にする

固定金額で Checkout Session を作成する

顧客が価格を選択できるようにする

動的な金額で Payment Links を使用する

一般的なパターン

顧客セグメント別の段階的な価格設定

数量ベースの価格設定

プロモーション価格

金額を検証する

トラブルシューティング

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​前提条件

​商品で Pay What You Want を有効にする

​固定金額で Checkout Session を作成する

​顧客が価格を選択できるようにする

​動的な金額で Payment Links を使用する

​一般的なパターン

​顧客セグメント別の段階的な価格設定

​数量ベースの価格設定

​プロモーション価格

​金額を検証する

​トラブルシューティング

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

前提条件

商品で Pay What You Want を有効にする

固定金額で Checkout Session を作成する

顧客が価格を選択できるようにする

動的な金額で Payment Links を使用する

一般的なパターン

顧客セグメント別の段階的な価格設定

数量ベースの価格設定

プロモーション価格

金額を検証する

トラブルシューティング