الدفع الديناميكي عند الخروج مع الدفع كما تريد

يتيح لك Pay What You Want (PWYW) تقديم أسعار متغيرة لمنتج واحد دون إنشاء إدخالات متعددة للمنتج. تحدّد سعرًا أدنى في لوحة التحكم، ثم تمرّر مبالغ ديناميكية عند إنشاء جلسات Checkout، أو تتيح للعملاء اختيار السعر. يناسب هذا النهج ما يلي:

التسعير المتغير دون إدارة منتجات متعددة
التسعير الذي يحدده العميل، حيث يختار المشترون المبلغ
التحكم البرمجي في السعر، حيث تحدّد المبلغ عبر API
نماذج التسعير المرنة للمنتجات الرقمية أو التبرعات أو عمليات الإطلاق التجريبية

يتوفر Pay What You Want لمنتجات الدفع لمرة واحدة فقط. ولا يمكن استخدامه مع الاشتراكات. يجب أن تكون العملة الأساسية للمنتج USD أو GBP أو EUR.

المتطلبات الأساسية

منتج دفع لمرة واحدة تم تفعيل Pay What You Want له في لوحة التحكم
معرّف المنتج (مثل pdt_123abc456def)
مفتاح API من Developer → API Keys

تفعيل 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 وسجّل معرّف المنتج لاستخدامه في جلسات Checkout.

يمكنك العثور على معرّف المنتج في لوحة التحكم ضمن Products → View Details، أو باستخدام List Products API.

إنشاء جلسة Checkout بمبلغ ثابت

عند تمرير amount في سلة المنتج، تستخدم Checkout ذلك المبلغ المحدد تمامًا كسعر الوحدة، ما دام يساوي السعر الأدنى للمنتج أو يتجاوزه. يستخدم الحقل 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"
  }'

يتم تجاهل الحقل amount للمنتجات التي لم يتم تفعيل Pay What You Want لها. وينطبق فقط على عمليات الدفع لمرة واحدة.

السماح للعملاء باختيار السعر

احذف الحقل 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 مع مبالغ ديناميكية

تقبل Payment Links الثابتة لمنتجات 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). يساعدك ذلك في تحليل أنماط التسعير وسلوك العملاء.

التحقق من المبالغ

تحقق من أن المبلغ يساوي السعر الأدنى لمنتجك أو يتجاوزه قبل إنشاء جلسة Checkout. يمثل 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 جلسات Checkout التي يكون مبلغها أقل من السعر الأدنى لمنتجك. تحقّق من المبالغ قبل إنشاء الجلسات، أو احذف الحقل amount للسماح للعملاء بالاختيار.

Customer can't enter their own price

إذا لم يظهر حقل إدخال السعر، فتأكد من حذف الحقل amount من سلة المنتج. عند توفير amount، تستخدم Checkout ذلك المبلغ المحدد تمامًا.

Checkout Sessions API

مرجع API الكامل لجلسات Checkout.

Checkout Sessions Guide

استكشف ميزات جلسات Checkout المتقدمة وخيارات التخصيص.

Pay What You Want Feature

تعرّف على المزيد حول نموذج تسعير Pay What You Want.

Integration Guides

Billing Deconstructions

Cookbooks

الدفع الديناميكي عند الخروج مع الدفع كما تريد

المتطلبات الأساسية

تفعيل Pay What You Want على منتج

إنشاء جلسة Checkout بمبلغ ثابت

السماح للعملاء باختيار السعر

استخدام Payment Links مع مبالغ ديناميكية

الأنماط الشائعة

التسعير المتدرج حسب شريحة العملاء

التسعير حسب الكمية

التسعير الترويجي

التحقق من المبالغ

استكشاف الأخطاء وإصلاحها

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

​المتطلبات الأساسية

​تفعيل Pay What You Want على منتج

​إنشاء جلسة Checkout بمبلغ ثابت

​السماح للعملاء باختيار السعر

​استخدام Payment Links مع مبالغ ديناميكية

​الأنماط الشائعة

​التسعير المتدرج حسب شريحة العملاء

​التسعير حسب الكمية

​التسعير الترويجي

​التحقق من المبالغ

​استكشاف الأخطاء وإصلاحها

Checkout Sessions API

Checkout Sessions Guide

Pay What You Want Feature

المتطلبات الأساسية

تفعيل Pay What You Want على منتج

إنشاء جلسة Checkout بمبلغ ثابت

السماح للعملاء باختيار السعر

استخدام Payment Links مع مبالغ ديناميكية

الأنماط الشائعة

التسعير المتدرج حسب شريحة العملاء

التسعير حسب الكمية

التسعير الترويجي

التحقق من المبالغ

استكشاف الأخطاء وإصلاحها