Dynamic Pricing Checkout dengan Pay What You Want

Pay What You Want (PWYW) memungkinkan Anda menawarkan harga variabel untuk satu produk tanpa membuat beberapa entri produk. Anda menetapkan harga minimum di dashboard, lalu meneruskan jumlah dinamis saat membuat checkout session, atau membiarkan pelanggan memilih harganya. Pendekatan ini cocok untuk:

Harga variabel tanpa perlu mengelola beberapa produk
Harga yang ditentukan pelanggan, yaitu pembeli memilih jumlahnya
Kontrol harga secara programatis, yaitu Anda menetapkan jumlahnya melalui API
Model harga fleksibel untuk produk digital, donasi, atau peluncuran eksperimental

Pay What You Want hanya tersedia untuk produk pembayaran satu kali. Fitur ini tidak dapat digunakan dengan subscription. Mata uang dasar produk harus USD, GBP, atau EUR.

Prasyarat

Produk pembayaran satu kali dengan Pay What You Want yang diaktifkan di dashboard
ID produk (misalnya, pdt_123abc456def)
API key dari Developer → API Keys

Aktifkan Pay What You Want pada Produk

Di dashboard Dodo Payments:

Go to Products

Buka Products dan pilih produk pembayaran satu kali yang ingin Anda konfigurasi.

Enable Pay What You Want

Di bagian Pricing, aktifkan Pay What You Want.

Set the minimum price

Masukkan Minimum Price yang harus dibayar pelanggan. Ini wajib diisi.

Set a suggested price (optional)

Secara opsional, tetapkan Suggested Price untuk memandu pelanggan. Tidak ada pengaturan harga maksimum. Untuk membatasi jumlah yang Anda kenakan, terapkan batas tersebut dalam kode Anda sendiri sebelum membuat session.

Save

Klik Update Product dan catat ID produk Anda untuk digunakan dalam checkout session.

Anda dapat menemukan ID produk di dashboard melalui Products → View Details, atau dengan menggunakan List Products API.

Buat Checkout Session dengan Jumlah Tetap

Saat Anda meneruskan amount di keranjang produk, checkout menggunakan jumlah tersebut sebagai harga satuan, selama jumlahnya sama dengan atau lebih besar dari harga minimum produk. Field amount menggunakan unit mata uang terkecil: cents untuk USD, pence untuk GBP, dan cents untuk EUR. Misalnya, 1500 = $15.00 atau €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"
  }'

Field amount diabaikan untuk produk yang tidak mengaktifkan Pay What You Want. Field ini hanya berlaku untuk pembayaran satu kali.

Biarkan Pelanggan Memilih Harganya

Abaikan field amount untuk menampilkan input harga saat checkout. Pelanggan dapat memasukkan jumlah berapa pun yang sama dengan atau lebih besar dari harga minimum produk Anda.

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

Gunakan Payment Links dengan Jumlah Dinamis

Payment link statis untuk produk Pay What You Want menerima parameter query paymentAmount yang menetapkan jumlah yang dikenakan. Berbeda dengan Checkout Sessions API, parameter ini menggunakan unit mata uang utama (misalnya, 12.5 untuk $12.50).

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

paymentAmount menggunakan unit mata uang utama (15.00 adalah $15.00). Field Checkout Sessions API product_cart[].amount menggunakan unit mata uang terkecil (1500 adalah $15.00). Lihat Integration Guide untuk detail selengkapnya.

Pola Umum

Harga Bertingkat berdasarkan Segmen Pelanggan

Kenakan jumlah berbeda kepada jenis pelanggan yang berbeda menggunakan produk yang sama:

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

Harga berdasarkan Kuantitas

Sesuaikan harga satuan berdasarkan kuantitas yang dibeli. amount adalah harga per unit, dan totalnya adalah 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',
  });
}

Harga Promosi

Terapkan harga yang dibatasi waktu:

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

Gunakan metadata untuk melacak alasan jumlah tertentu dipilih (misalnya, pricing_tier, discount_code, user_segment). Ini membantu Anda menganalisis pola harga dan perilaku pelanggan.

Validasi Jumlah

Pastikan jumlah tersebut sama dengan atau lebih besar dari harga minimum produk Anda sebelum membuat checkout session. maxAmount adalah batas bisnis Anda sendiri; Dodo Payments tidak memiliki pengaturan harga maksimum.

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

Pemecahan Masalah

Amount is being ignored

Pastikan bahwa:

Produk telah mengaktifkan Pay What You Want di dashboard
Produk tersebut merupakan produk pembayaran satu kali, bukan subscription
Jumlah menggunakan format yang benar (unit mata uang terkecil: cents untuk USD, pence untuk GBP, dan cents untuk EUR)

Amount is below the minimum price

API menolak checkout session jika jumlahnya berada di bawah harga minimum produk Anda. Validasi jumlah sebelum membuat session, atau abaikan field amount agar pelanggan dapat memilih.

Customer can't enter their own price

Jika field input harga tidak muncul, pastikan Anda telah menghilangkan field amount dari keranjang produk. Jika amount diberikan, checkout akan menggunakan jumlah tersebut secara persis.

Checkout Sessions API

Referensi API lengkap untuk checkout session.

Checkout Sessions Guide

Pelajari fitur lanjutan checkout session dan opsi penyesuaiannya.

Pay What You Want Feature

Pelajari lebih lanjut tentang model harga Pay What You Want.

Integration Guides

Billing Deconstructions

Cookbooks

Dynamic Pricing Checkout dengan Pay What You Want

Prasyarat

Aktifkan Pay What You Want pada Produk

Buat Checkout Session dengan Jumlah Tetap

Biarkan Pelanggan Memilih Harganya

Gunakan Payment Links dengan Jumlah Dinamis

Pola Umum

Harga Bertingkat berdasarkan Segmen Pelanggan

Harga berdasarkan Kuantitas

Harga Promosi

Validasi Jumlah

Pemecahan Masalah

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​Prasyarat

​Aktifkan Pay What You Want pada Produk

​Buat Checkout Session dengan Jumlah Tetap

​Biarkan Pelanggan Memilih Harganya

​Gunakan Payment Links dengan Jumlah Dinamis

​Pola Umum

​Harga Bertingkat berdasarkan Segmen Pelanggan

​Harga berdasarkan Kuantitas

​Harga Promosi

​Validasi Jumlah

​Pemecahan Masalah

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

Prasyarat

Aktifkan Pay What You Want pada Produk

Buat Checkout Session dengan Jumlah Tetap

Biarkan Pelanggan Memilih Harganya

Gunakan Payment Links dengan Jumlah Dinamis

Pola Umum

Harga Bertingkat berdasarkan Segmen Pelanggan

Harga berdasarkan Kuantitas

Harga Promosi

Validasi Jumlah

Pemecahan Masalah