원하는 가격으로 동적 가격 책정 체크아웃

Pay What You Want (PWYW)를 사용하면 여러 product 항목을 생성하지 않고도 단일 product에 가변 가격을 적용할 수 있습니다. dashboard에서 최소 가격을 설정한 다음 checkout session을 생성할 때 동적 금액을 전달하거나 고객이 가격을 선택하도록 할 수 있습니다. 이 방식은 다음과 같은 경우에 사용할 수 있습니다:

여러 product를 관리하지 않고 가변 가격 적용
구매자가 금액을 선택하는 고객 주도 가격 책정
API를 통해 금액을 설정하는 프로그래밍 방식의 가격 제어
디지털 product, 기부 또는 실험적 출시를 위한 유연한 가격 모델

Pay What You Want는 일회성 결제 product에서만 사용할 수 있습니다. subscription에는 사용할 수 없습니다. product의 기본 통화는 USD, GBP 또는 EUR여야 합니다.

사전 요구 사항

dashboard에서 Pay What You Want가 활성화된 일회성 결제 product
product ID (예: pdt_123abc456def)
Developer → API Keys에서 발급한 API key

Product에서 Pay What You Want 활성화

Dodo Payments dashboard에서:

Go to Products

Products로 이동하여 구성하려는 일회성 결제 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 session에서 사용할 product ID를 기록해 둡니다.

dashboard의 Products → View Details에서 product ID를 확인하거나 List Products API를 사용할 수 있습니다.

고정 금액으로 Checkout Session 생성

product cart에 amount를 전달하면 해당 금액이 product의 최소 가격 이상인 경우 checkout에서 정확히 그 금액을 단가로 사용합니다. 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가 활성화되지 않은 product에서는 amount 필드가 무시됩니다. 이 필드는 일회성 결제에만 적용됩니다.

고객이 가격을 선택하도록 허용

checkout에 가격 입력란을 표시하려면 amount 필드를 생략합니다. 고객은 product의 최소 가격 이상인 금액을 입력할 수 있습니다.

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 product의 정적 payment link는 청구 금액을 고정하는 paymentAmount query parameter를 허용합니다. Checkout Sessions API와 달리 이 parameter는 주요 통화 단위를 사용합니다(예: 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를 참조하세요.

일반적인 패턴

고객 세그먼트별 계층형 가격 책정

동일한 product를 사용하여 고객 유형별로 서로 다른 금액을 청구합니다:

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). 이를 통해 가격 패턴과 고객 행동을 분석할 수 있습니다.

금액 검증

checkout session을 생성하기 전에 금액이 product의 최소 가격 이상인지 확인하세요. 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

다음을 확인하세요:

dashboard에서 product에 Pay What You Want가 활성화되어 있는지
product가 subscription이 아닌 일회성 결제 product인지
금액 형식이 올바른지 (통화의 최소 단위: USD는 cents, GBP는 pence, EUR는 cents)

Amount is below the minimum price

API는 금액이 product의 최소 가격보다 낮은 checkout session을 거부합니다. session을 생성하기 전에 금액을 검증하거나 amount 필드를 생략하여 고객이 가격을 선택하도록 하세요.

Customer can't enter their own price

가격 입력란이 표시되지 않으면 product cart에서 amount 필드를 생략했는지 확인하세요. amount가 제공되면 checkout에서는 해당 금액을 정확히 사용합니다.

Checkout Sessions API

checkout session에 대한 전체 API reference입니다.

Checkout Sessions Guide

고급 checkout session 기능과 customization 옵션을 살펴보세요.

Pay What You Want Feature

Pay What You Want 가격 모델에 대해 자세히 알아보세요.

Integration Guides

Billing Deconstructions

Cookbooks

원하는 가격으로 동적 가격 책정 체크아웃

사전 요구 사항

Product에서 Pay What You Want 활성화

고정 금액으로 Checkout Session 생성

고객이 가격을 선택하도록 허용

동적 금액으로 Payment Links 사용

일반적인 패턴

고객 세그먼트별 계층형 가격 책정

수량 기반 가격 책정

프로모션 가격 책정

금액 검증

문제 해결

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​사전 요구 사항

​Product에서 Pay What You Want 활성화

​고정 금액으로 Checkout Session 생성

​고객이 가격을 선택하도록 허용

​동적 금액으로 Payment Links 사용

​일반적인 패턴

​고객 세그먼트별 계층형 가격 책정

​수량 기반 가격 책정

​프로모션 가격 책정

​금액 검증

​문제 해결

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

사전 요구 사항

Product에서 Pay What You Want 활성화

고정 금액으로 Checkout Session 생성

고객이 가격을 선택하도록 허용

동적 금액으로 Payment Links 사용

일반적인 패턴

고객 세그먼트별 계층형 가격 책정

수량 기반 가격 책정

프로모션 가격 책정

금액 검증

문제 해결