نماذج الفوترة الهجينة - Dodo Payments Documentation

تجمع الفوترة الهجينة بين نموذجَي فوترة أو أكثر ضمن استراتيجية تسعير واحدة. يتيح لك ذلك تحصيل القيمة من أبعاد مختلفة—مثل الرسوم المتكررة والاستخدام والمقاعد والميزات—مع منح العملاء المرونة وإمكانية التنبؤ بالتكاليف.

Usage-Based Billing

الأساس للتسعير القائم على الاستهلاك.

Subscriptions

الأساس للفوترة المتكررة.

Add-ons

مدّد الاشتراكات بترقيات اختيارية.

Seat-Based Billing

نماذج تسعير لكل مستخدم.

ما الفوترة الهجينة؟

تجمع الفوترة الهجينة بين أبعاد تسعير متعددة ضمن عرض منتج واحد. وبدلاً من الاختيار بين الاشتراكات ذات السعر الثابت أو التسعير القائم على الاستخدام، يمكنك استخدام النموذجين معًا.

لماذا تستخدم الفوترة الهجينة؟

الهدف التجاري	الحل الهجين
إيرادات يمكن التنبؤ بها + إمكانية النمو	اشتراك أساسي + تجاوز الاستخدام
تسعير الفرق القابل للتوسع	لكل مقعد + إضافات الميزات
استقطاب العملاء ثم التوسع لاحقًا	رسوم أساسية منخفضة + رسوم الاستهلاك
مرونة المؤسسات	إنفاق ملتزم به + رسوم عند الطلب
تسعير عادل للاستخدام المتغير	حصة مشمولة + الدفع حسب الاستخدام

الأنماط الهجينة الشائعة

النموذج	الوصف	المثال	الدعم الأصلي
1. الاشتراك + الاستخدام	رسوم أساسية + رسوم الاستهلاك	$49/شهريًا + $0.01/استدعاء API بعد 10 آلاف مجانًا	✅ كامل
2. الاشتراك + المقاعد	رسوم المنصة + رسوم لكل مستخدم	$99/شهريًا + $15/مقعد	✅ كامل
3. الاشتراك + إضافات الميزات	الخطة الأساسية + ترقيات اختيارية	$29/شهريًا + $19/شهريًا للتحليلات + $9/شهريًا للوصول إلى API	✅ كامل
4. المقاعد + الاستخدام	رسوم لكل مستخدم + تجاوز الاستهلاك	$10/مستخدم/شهريًا + $0.05/GB بعد 5GB/مستخدم	⚠️ حل بديل
5. الاشتراك + المقاعد + الاستخدام	المنصة + المستخدمون + الاستهلاك (هجين ثلاثي)	$199/شهريًا + $20/مقعد + تجاوز الاستخدام	⚠️ حل بديل
6. الأساس المتدرج + تجاوز الاستخدام	مستويات مختلفة بحصص مختلفة	المبتدئة (5 آلاف استدعاء) مقابل الاحترافية (50 ألف استدعاء) + التجاوز	✅ كامل
7. الاشتراك + الرسوم عند الطلب	رسوم متكررة + رسوم يدوية متغيرة	مبلغ احتفاظ قدره $99/شهريًا + فوترة العمل بالساعة	✅ كامل

النموذج الهجين 1: الاشتراك + الاستخدام

هذا هو النموذج الهجين الأكثر شيوعًا. يدفع العملاء رسوم اشتراك أساسية، بالإضافة إلى رسوم الاستهلاك الذي يتجاوز الحصص المشمولة.

آلية العمل

الخطة الاحترافية: $49/شهريًا

المشمول: 10,000 استدعاء API/شهريًا
التجاوز: $0.005 لكل استدعاء بعد 10,000

حساب نموذجي (يستخدم العميل 25,000 استدعاء هذا الشهر):

الاشتراك الأساسي: $49.00
التجاوز: (25,000 - 10,000) × $0.005 =$ 75.00
الإجمالي: $124.00

حالات الاستخدام

منصات API: وصول أساسي + رسوم لكل طلب
خدمات AI/ML: اشتراك + استخدام الرموز/التوليد
خدمات التخزين: خطة أساسية + تجاوز لكل GB
منصات الاتصالات: رسوم أساسية + رسوم لكل رسالة/دقيقة

التنفيذ

Create Usage Meter

أنشئ مقياسًا لتتبع بُعد الاستخدام القابل للفوترة.

Dashboard: Meters → Create Meter
Event Name: "api.call"
Aggregation: Count
This tracks API calls per customer

Create Subscription Product with Usage Pricing

أنشئ منتج اشتراك وأرفق به مقياس الاستخدام مع التسعير.

Dashboard: Create Product → Subscription
Name: "Pro Plan"
Base Price: $49/month

Then attach usage pricing:
- Meter: api.call
- Price per unit: $0.005
- Free threshold: 10,000 (included in subscription)

يُرفق مقياس الاستخدام مباشرةً بمنتج الاشتراك. تُحسب رسوم الاستخدام وتُضاف إلى فاتورة الاشتراك تلقائيًا.

Create Checkout Session

أنشئ جلسة دفع باستخدام منتج الاشتراك الخاص بك.

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_pro_plan', quantity: 1 }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

Send Usage Events

تتبّع الاستخدام طوال فترة الفوترة.

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `call_${Date.now()}`,
      customer_id: 'cus_123',
      event_name: 'api.call',
      timestamp: new Date().toISOString(),
      metadata: { endpoint: '/v1/generate' }
    }]
  })
});

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

Included Allowance
Zero Base + Pure Usage
Tiered Allowances

تغطي العتبة المجانية الاستخدام المشمول في الاشتراك الأساسي.الخطة الاحترافية: $49/شهريًا

تشمل: 10,000 استدعاء API
التجاوز: $0.005/استدعاء بعد 10,000
يستخدم العميل 8,000 ← يدفع $49 (من دون تجاوز)

النموذج الهجين 2: الاشتراك + المقاعد

رسوم المنصة بالإضافة إلى رسوم لكل مستخدم. مثالي لأدوات التعاون الجماعي وSaaS الموجهة إلى الشركات.

آلية العمل

خطة الفريق: $99/شهريًا +$ 15/مقعد

رسوم المنصة الأساسية: $99/شهريًا (تشمل 3 مقاعد)
المقاعد الإضافية: $15/مقعد/شهريًا

حساب نموذجي (فريق مكوّن من 12 مستخدمًا):

رسوم المنصة: $99.00
المقاعد الإضافية: (12 - 3) × $15 =$ 135.00
الإجمالي: $234.00/شهريًا

حالات الاستخدام

أدوات التعاون: رسوم مساحة العمل + رسوم لكل عضو
أنظمة CRM: ترخيص المنصة + رسوم لكل مندوب مبيعات
إدارة المشاريع: خطة الفريق + رسوم لكل مساهم
أدوات المطورين: رسوم المؤسسة + رسوم لكل مطور

التنفيذ

Create Seat Add-on

أنشئ إضافة للمقاعد الإضافية.

Dashboard: Products → Add-ons → Create Add-on
Name: "Additional Seat"
Price: $15/month
Description: "Add another team member"

Create Base Subscription

أنشئ منتج الاشتراك مع رسوم المنصة وأرفق الإضافة به.

Dashboard: Create Product → Subscription
Name: "Team Plan"
Price: $99/month
Description: "Includes 3 team members"

Then in Add-ons section:
- Attach: "Additional Seat" add-on

Create Checkout with Seats

حدّد عدد المقاعد أثناء الدفع.

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_team_plan',
    quantity: 1,
    addons: [{
      addon_id: 'addon_seat',
      quantity: 9  // 9 extra seats (12 total with 3 included)
    }]
  }],
  customer: { email: 'admin@company.com' },
  return_url: 'https://yourapp.com/success'
});

Adjust Seats as Needed

أضف المقاعد أو أزلها من الاشتراكات الحالية.

// Add 5 more seats
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_team_plan',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  addons: [{
    addon_id: 'addon_seat',
    quantity: 14  // New total: 14 extra seats
  }]
});

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

Included Seats
Pure Per-Seat
Tiered Per-Seat

تتضمن الخطة الأساسية بعض المقاعد، وتُفرض رسوم على المقاعد الإضافية.خطة الفريق: $99/شهريًا

تشمل: 5 مقاعد
المقاعد الإضافية: $15/مقعد/شهريًا
20 مستخدمًا = $99 + (15 × $15) = $324/شهريًا

النموذج الهجين 3: الاشتراك + إضافات الميزات

اشتراك أساسي مع ترقيات ميزات اختيارية يمكن للعملاء إضافتها.

آلية العمل

الخطة الأساسية: $29/شهريًا الإضافات الاختيارية:

التحليلات المتقدمة: +$19/شهريًا
الوصول إلى API: +$9/شهريًا
الدعم ذي الأولوية: +$29/شهريًا
العلامة البيضاء: +$49/شهريًا

حساب نموذجي (يختار العميل الخطة الأساسية + التحليلات + الوصول إلى API):

الخطة الأساسية: $29.00
التحليلات: $19.00
الوصول إلى API: $9.00
الإجمالي: $57.00/شهريًا

حالات الاستخدام

منصات SaaS: الميزات الأساسية + الوحدات المميزة
أدوات التسويق: الأداة الأساسية + عمليات التكامل
منتجات التحليلات: لوحة المعلومات + التقارير المتقدمة
برامج الأمان: الحماية الأساسية + الميزات المتقدمة

التنفيذ

Create Feature Add-ons

أنشئ إضافة لكل ميزة اختيارية.

# Add-on 1: Advanced Analytics
Dashboard: Products → Add-ons → Create Add-on
Name: "Advanced Analytics"
Price: $19/month

# Add-on 2: API Access
Name: "API Access"
Price: $9/month

# Add-on 3: Priority Support
Name: "Priority Support"
Price: $29/month

# Add-on 4: White-label
Name: "White-label"
Price: $49/month

Create Core Subscription

حدّد اشتراكك الأساسي وأرفق به جميع إضافات الميزات.

Dashboard: Create Product → Subscription
Name: "Core Plan"
Price: $29/month

Then in Add-ons section:
- Attach all feature add-ons

Let Customers Choose

أكمل الدفع باستخدام الميزات المحددة.

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_core_plan',
    quantity: 1,
    addons: [
      { addon_id: 'addon_analytics', quantity: 1 },
      { addon_id: 'addon_api_access', quantity: 1 }
      // Customer didn't select support or white-label
    ]
  }],
  return_url: 'https://yourapp.com/success'
});

Add Features Later

يمكن للعملاء إضافة ميزات إلى الاشتراكات الحالية.

// Customer wants to add Priority Support
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_core_plan',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  addons: [
    { addon_id: 'addon_analytics', quantity: 1 },
    { addon_id: 'addon_api_access', quantity: 1 },
    { addon_id: 'addon_priority_support', quantity: 1 }  // New!
  ]
});

النموذج الهجين 4: المقاعد + الاستخدام

رسوم لكل مستخدم مدمجة مع رسوم قائمة على الاستهلاك. يحصل كل مستخدم على حصة.

القيد: لا يدعم Dodo Payments حاليًا إرفاق مقاييس الاستخدام والإضافات بمنتج الاشتراك نفسه. يتطلب هذا النموذج استخدام حل بديل يعتمد على منطق على مستوى التطبيق.

كيف يعمل

تحليلات الفريق: 20 دولارًا أمريكيًا/مستخدم/شهر يتضمن كل مستخدم:

معالجة بيانات بسعة 5 GB شهريًا
الاستخدام الزائد: 2 دولار أمريكي/GB بعد الحصة المسموح بها

مثال على الحساب (فريق مكوّن من 10 مستخدمين يستخدم 80 GB إجمالًا):

رسوم المقاعد: 10 × 20 دولارًا أمريكيًا = 200.00 دولار أمريكي
البيانات المضمنة: 10 × 5 GB = 50 GB
الاستخدام الزائد: (80 - 50) × 2 دولار أمريكي = 60.00 دولارًا أمريكيًا
الإجمالي: 260.00 دولارًا أمريكيًا/شهر

حالات الاستخدام

منصات التحليلات: لكل محلل + معالجة البيانات
أدوات التصميم: لكل مصمم + التخزين/عمليات التصدير
بيئات التطوير: لكل مطور + ساعات الحوسبة
أدوات التواصل: لكل مستخدم + حجم الرسائل/المكالمات

خيارات التنفيذ

نظرًا إلى أنه لا يمكنك إرفاق عدادات الاستخدام والإضافات معًا بالاشتراك نفسه، اختر أحد الأساليب التالية:

Option A: Usage Product + App-Managed Seats
Option B: Seat Add-on + On-Demand Usage Charges

استخدم اشتراكًا قائمًا على الاستخدام وأدر فوترة المقاعد في تطبيقك.

Create Usage Meter

Dashboard: Meters → Create Meter
Event Name: "data.processed"
Aggregation: Sum
Property: "bytes"

Create Usage-Based Subscription

Dashboard: Create Product → Subscription
Name: "Team Analytics"
Base Price: $0/month

Attach usage pricing:
- Meter: data.processed
- Price per unit: $2/GB
- Free threshold: 0 (managed by your app)

Manage Seats in Your Application

تتبّع عدد المقاعد واحسب رسوم المقاعد بشكل منفصل.

// Your application tracks seats and calculates total cost
async function calculateMonthlyBill(customerId: string) {
  const seatCount = await getSeatCount(customerId);
  const seatFee = seatCount * 20; // $20/seat

  // Usage is billed by Dodo automatically
  // You invoice/charge seat fees separately or include in base price

  // Alternatively, adjust base subscription price when seats change
  const totalBasePrice = seatCount * 2000; // $20/seat in cents
  await client.subscriptions.update('sub_123', {
    // Update subscription to reflect seat-based pricing
  });
}

Calculate Dynamic Free Threshold

عدّل الاستخدام المضمن بناءً على عدد المقاعد.

// When checking usage, apply per-seat allowance
async function checkUsageOverage(customerId: string) {
  const seatCount = await getSeatCount(customerId);
  const includedGB = seatCount * 5; // 5 GB per user

  const currentUsage = await getUsageFromDodo(customerId);
  const overage = Math.max(0, currentUsage - includedGB);

  // Overage is billed by Dodo at $2/GB
  return { included: includedGB, used: currentUsage, overage };
}

استخدم الإضافات للمقاعد واحتسب رسوم الاستخدام يدويًا عبر رسوم عند الطلب.

Create Seat Add-on

Dashboard: Products → Add-ons → Create Add-on
Name: "Team Member"
Price: $20/month

Create Subscription with Add-on

Dashboard: Create Product → Subscription
Name: "Team Analytics"
Base Price: $0/month

Attach add-on:
- "Team Member" add-on

Enable on-demand charging

Track Usage in Your Application

// Track usage events in your system
async function trackDataProcessed(customerId: string, bytes: number) {
  await saveUsageEvent({
    customer_id: customerId,
    event_type: 'data.processed',
    bytes: bytes,
    timestamp: new Date()
  });
}

Charge Usage at End of Cycle

احسب رسوم الاستخدام الزائد واحتسبها يدويًا.

async function billUsageOverage(subscriptionId: string) {
  const subscription = await getSubscription(subscriptionId);
  const seatCount = subscription.addons.find(a => a.id === 'addon_seat')?.quantity || 0;

  const includedGB = seatCount * 5;
  const usedGB = await calculatePeriodUsage(subscription.customer_id);
  const overageGB = Math.max(0, usedGB - includedGB);

  if (overageGB > 0) {
    const overageCharge = overageGB * 200; // $2/GB in cents
    await client.subscriptions.charge(subscriptionId, {
      product_price: overageCharge,
      product_description: `Data overage: ${overageGB} GB × $2/GB`
    });
  }
}

التوصية: غالبًا ما يكون الخيار B (إضافة المقاعد + الاستخدام عند الطلب) أسهل في التنفيذ لأن Dodo يتولى فوترة المقاعد تلقائيًا. كل ما تحتاج إليه هو تتبّع الاستخدام الزائد واحتسابه.

النموذج الهجين 5: الاشتراك + المقاعد + الاستخدام (هجين ثلاثي)

النموذج الأكثر شمولًا: رسوم المنصة + رسوم لكل مستخدم + الاستهلاك.

القيد: لا يدعم Dodo Payments حاليًا إرفاق عدادات الاستخدام والإضافات معًا بمنتج الاشتراك نفسه. يتطلب هذا النموذج اتباع أسلوب بديل.

كيف يعمل

منصة المؤسسات

رسوم المنصة: 199 دولارًا أمريكيًا/شهر
لكل مقعد: 25 دولارًا أمريكيًا/مستخدم/شهر
الاستخدام: 0.10 دولار أمريكي/1000 استدعاء API (يتضمن 50K)

مثال على الحساب (شركة تضم 20 مستخدمًا و150,000 استدعاء API):

المنصة: 199.00 دولار أمريكي
المقاعد: 20 × 25 دولارًا أمريكيًا = 500.00 دولار أمريكي
الاستخدام: (150K - 50K) × $0.10/1K = $10.00
الإجمالي: 709.00 دولار أمريكي/شهر

حالات الاستخدام

SaaS للمؤسسات: المنصة + الفريق + الاستهلاك
منصات البيانات: مساحة العمل + المحللون + الاستعلامات
منصات التكامل: المركز + الموصلات + المعاملات
منصات الذكاء الاصطناعي: مساحة العمل + المطورون + الاستدلال

خيارات التنفيذ

اختر أحد الأساليب التالية لتنفيذ الفوترة الهجينة الثلاثية:

Option A: Base + Seats (Add-on) + On-Demand Usage
Option B: Base + Usage (Meter) + App-Managed Seats

استخدم اشتراكًا مع إضافات المقاعد، واحتسب رسوم الاستخدام يدويًا عبر رسوم عند الطلب.هذا هو الأسلوب الموصى به لأن Dodo يتولى رسوم المنصة وفوترة المقاعد تلقائيًا.

Create Seat Add-on

Dashboard: Products → Add-ons → Create Add-on
Name: "User Seat"
Price: $25/month

Create Subscription Product

Dashboard: Create Product → Subscription
Name: "Enterprise Platform"
Base Price: $199/month

Attach add-on:
- "User Seat" add-on

Enable on-demand charging

Create Checkout with Seats

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_enterprise_platform',
    quantity: 1,
    addons: [{
      addon_id: 'addon_user_seat',
      quantity: 20  // 20 users
    }]
  }],
  customer: { email: 'enterprise@company.com' },
  return_url: 'https://yourapp.com/success'
});

Track Usage in Your Application

خزّن أحداث الاستخدام في نظامك.

// Track API calls in your system
async function trackApiCall(customerId: string, endpoint: string) {
  await saveUsageEvent({
    customer_id: customerId,
    event_type: 'api.call',
    endpoint: endpoint,
    timestamp: new Date()
  });
}

Charge Usage at End of Cycle

احسب رسوم الاستخدام الزائد واحتسبها عبر رسوم عند الطلب.

async function billUsageOverage(subscriptionId: string) {
  const usage = await calculatePeriodUsage(subscriptionId);
  const includedCalls = 50000;
  const overageCalls = Math.max(0, usage.totalCalls - includedCalls);

  if (overageCalls > 0) {
    // $0.10 per 1000 calls = $0.0001 per call
    const overageCharge = Math.ceil(overageCalls / 1000) * 10; // cents
    await client.subscriptions.charge(subscriptionId, {
      product_price: overageCharge,
      product_description: `API usage: ${overageCalls.toLocaleString()} calls over 50K included`
    });
  }
}

استخدم اشتراكًا مع عداد استخدام، وأدر فوترة المقاعد في تطبيقك.

Create Usage Meter

Dashboard: Meters → Create Meter
Event Name: "api.call"
Aggregation: Count

Create Subscription Product with Usage

Dashboard: Create Product → Subscription
Name: "Enterprise Platform"
Base Price: $199/month

Attach usage pricing:
- Meter: api.call
- Price: $0.10 per 1000 calls
- Free threshold: 50,000

Manage Seats in Your Application

تتبّع عدد المقاعد وعدّل السعر الأساسي للاشتراك وفقًا لذلك.

// When seats change, update subscription price
async function updateSeatCount(subscriptionId: string, newSeatCount: number) {
  const basePlatformFee = 19900; // $199 in cents
  const perSeatFee = 2500; // $25 in cents
  const totalPrice = basePlatformFee + (newSeatCount * perSeatFee);

  // Store seat count in your system
  await updateSeatsInDatabase(subscriptionId, newSeatCount);

  // Note: You may need to handle this via plan changes or
  // create multiple tier products for common seat counts
}

Send Usage Events to Dodo

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `api_${Date.now()}`,
      customer_id: 'cus_enterprise',
      event_name: 'api.call',
      timestamp: new Date().toISOString()
    }]
  })
});

التوصية: يكون الخيار A (الأساس + المقاعد + الاستخدام عند الطلب) أسهل عمومًا لأن Dodo يتولى فوترة المنصة والمقاعد تلقائيًا. كل ما تحتاج إليه هو تتبّع الاستخدام وإرسال الرسوم في نهاية كل دورة فوترة.

النموذج الهجين 6: الأساس المتدرج + الاستخدام الزائد

مستويات اشتراك مختلفة، لكل منها حصص مضمنة ومعدلات استخدام زائد مختلفة.

كيف يعمل

المستوى	السعر	الاستدعاءات المضمنة	معدل الاستخدام الزائد
المبتدئ	19 دولارًا أمريكيًا/شهر	1,000	0.02 دولار أمريكي/استدعاء
المحترف	79 دولارًا أمريكيًا/شهر	25,000	0.01 دولار أمريكي/استدعاء
الأعمال	199 دولارًا أمريكيًا/شهر	100,000	0.005 دولار أمريكي/استدعاء
المؤسسات	499 دولارًا أمريكيًا/شهر	500,000	0.002 دولار أمريكي/استدعاء

التنفيذ

أنشئ منتجات اشتراك منفصلة لكل مستوى، مع إعداد الاستخدام الخاص به:

# For each tier, create a subscription product:

# Starter Tier
Dashboard: Create Product → Subscription
Name: "Starter"
Base Price: $19/month
Usage Pricing:
- Meter: api.call
- Price: $0.02/call
- Free threshold: 1,000

# Pro Tier
Name: "Pro"
Base Price: $79/month
Usage Pricing:
- Meter: api.call
- Price: $0.01/call
- Free threshold: 25,000

# ... and so on for Business and Enterprise

مسار الترقية

عند ترقية العملاء إلى مستويات أعلى، يحصلون على:

حصة مضمنة أكبر
معدلات استخدام زائد أقل
قيمة أكبر مقابل كل دولار

// Customer upgrades from Starter to Pro
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

النموذج الهجين 7: الاشتراك + الرسوم عند الطلب

اشتراك متكرر بالإضافة إلى رسوم يدوية متغيرة مقابل الخدمات أو الاستخدام الزائد.

كيف يعمل

خطة الاحتفاظ: 199 دولارًا أمريكيًا/شهر تتضمن:

الوصول إلى المنصة
5 ساعات استشارات شهريًا
دعم عبر البريد الإلكتروني

الرسوم عند الطلب (حسب الحاجة):

استشارات إضافية: 150 دولارًا أمريكيًا/ساعة
تطوير مخصص: 200 دولار أمريكي/ساعة
دعم طارئ: 100 دولار أمريكي/حادثة

مثال على الحساب (هذا الشهر):

خطة الاحتفاظ: 199.00 دولار أمريكي
3 ساعات استشارات إضافية: 450.00 دولار أمريكي
دعم طارئ واحد: 100.00 دولار أمريكي
الإجمالي: 749.00 دولارًا أمريكيًا

حالات الاستخدام

الخدمات الاستشارية: خطة احتفاظ + فوترة بالساعة
الخدمات المُدارة: رسوم أساسية + رسوم الحوادث
خدمات الوكالات: رسوم شهرية + رسوم المشاريع
خطط الدعم: رسوم SLA + رسوم لكل تذكرة أو لكل ساعة

التنفيذ

Create On-Demand Subscription

أعدّ اشتراكًا مع تفعيل الفوترة عند الطلب.

const subscription = await client.subscriptions.create({
  billing: {
    city: 'San Francisco',
    country: 'US',
    state: 'CA',
    street: '123 Main St',
    zipcode: '94105'
  },
  customer: { customer_id: 'cus_123' },
  product_id: 'prod_retainer',
  quantity: 1,
  payment_link: true,
  return_url: 'https://yourapp.com/success',
  on_demand: {
    mandate_only: false,
    product_price: 19900  // $199 initial charge
  }
});

Charge for Services

أنشئ الرسوم عند تقديم الخدمات.

// Charge for 3 hours of consulting
await client.subscriptions.charge('sub_123', {
  product_price: 45000,  // $450.00 (3 × $150)
  product_description: 'Consulting - 3 hours (March 15)'
});

// Charge for emergency support incident
await client.subscriptions.charge('sub_123', {
  product_price: 10000,  // $100.00
  product_description: 'Emergency support - Server outage (March 18)'
});

Track and Invoice

تظهر جميع الرسوم في فاتورة العميل.

// Retrieve subscription charges
const payments = await client.payments.list({
  subscription_id: 'sub_123'
});

// Show itemized breakdown to customer
payments.items.forEach(payment => {
  console.log(`${payment.payment_id}: $${payment.total_amount / 100}`);
});

أمثلة من الواقع

توضح هذه الأمثلة هياكل التسعير المثالية. ونظرًا إلى القيد الذي يمنع إرفاق عدادات الاستخدام والإضافات بالمنتج نفسه، تتطلب بعض التركيبات حلولًا بديلة، مثل استخدام الرسوم عند الطلب للاستخدام أو إدارة المقاعد عبر التطبيق.

المثال 1: منصة AI SaaS

هيكل التسعير:

الاشتراك الأساسي: 99 دولارًا أمريكيًا/شهر (الوصول إلى المنصة، ويتضمن 5 مقاعد)
إضافة المقاعد: 20 دولارًا أمريكيًا/مقعد/شهر
إضافات الميزات: النماذج المخصصة ($49/شهر)، الوصول إلى API ($29/شهر)، قائمة الانتظار ذات الأولوية ($19/شهر)
الاستخدام الزائد: 0.02 دولار أمريكي لكل 1,000 رمز بعد 100K (يُحتسب عبر الرسوم عند الطلب)

التنفيذ: استخدم اشتراكًا مع إضافات المقاعد والميزات. تتبّع استخدام الرموز في تطبيقك واحتسب الاستخدام الزائد عبر الرسوم عند الطلب في نهاية دورة الفوترة. مثال على عميل (12 مستخدمًا، 500K رمز، النماذج المخصصة + الوصول إلى API):

المكوّن	الحساب	المبلغ
الأساس	رسوم المنصة	$99
المقاعد الإضافية	7 × $20	$140
النماذج المخصصة	إضافة	$49
الوصول إلى API	إضافة	$29
الاستخدام الزائد للرموز	400K × $0.02/1K (عند الطلب)	$8
الإجمالي		$325/شهر

المثال 2: منصة أدوات المطورين

خيارات المستوى:

	مجاني	محترف	مؤسسات
السعر	$0/شهر	$29/شهر	$199/شهر
المستخدمون	1	5 مضمنة	غير محدود
عمليات البناء	100	1,000	10,000
التخزين	1 GB	10 GB	100 GB

خيارات التنفيذ: الخيار A (يركز على الاستخدام): أنشئ منتجات مزودة بعدادات استخدام لعمليات البناء/التخزين. وأدر المستخدمين في تطبيقك. الخيار B (يركز على المقاعد): أنشئ منتجات مزودة بإضافات المقاعد. وتتبع استخدام عمليات البناء/التخزين واحتسب الاستخدام الزائد عبر الرسوم عند الطلب. الإضافات (عند استخدام الخيار B):

مستخدمون إضافيون: 10 دولارات أمريكية/مستخدم/شهر
عمليات بناء ذات أولوية: 19 دولارًا أمريكيًا/شهر
نطاقات مخصصة: 9 دولارات أمريكية/نطاق/شهر

المثال 3: أتمتة التسويق

هيكل التسعير:

الأساس: 79 دولارًا أمريكيًا/شهر (ميزات الأتمتة الأساسية، ويتضمن 3 مقاعد)
مستويات جهات الاتصال (إضافات): 1K مضمنة، 5K (+$30)، 25K (+$80)، 100K (+$200)
إضافات الميزات: التسويق عبر SMS ($29/شهر)، الصفحات المقصودة ($19/شهر)، اختبار A/B ($29/شهر)
مقاعد الفريق: إضافة بقيمة 15 دولارًا أمريكيًا/مستخدم/شهر
حجم البريد الإلكتروني: تتبّعه في التطبيق، واحتسب الاستخدام الزائد عبر الرسوم عند الطلب (1 دولار أمريكي/1,000 بريد إلكتروني يتجاوز الحد)

التنفيذ: استخدم اشتراكًا مع إضافات مستويات جهات الاتصال وإضافات الميزات وإضافات المقاعد. تتبّع عمليات إرسال البريد الإلكتروني في تطبيقك واحتسب الاستخدام الزائد عبر الرسوم عند الطلب.

أفضل ممارسات التنفيذ

وضوح صفحة التسعير

اجعل التسعير الهجين سهل الفهم. اعرض التكاليف الأساسية وما هو مضمن وكيفية عمل الاستخدام الزائد بشكل واضح في صفحة التسعير.

جيد: “$49/شهر يتضمن 10,000 استدعاء API. الاستدعاءات الإضافية: $0.005 لكل استدعاء” سيئ: “$49/شهر + رسوم الاستخدام”

إمكانية التنبؤ بالتكلفة

ساعد العملاء على تقدير تكاليفهم:

// Provide a cost calculator
function estimateMonthlyCost({
  plan,
  seats,
  expectedUsage,
  addons
}: EstimateParams): number {
  let total = plan.basePrice;

  // Add seat costs
  const extraSeats = Math.max(0, seats - plan.includedSeats);
  total += extraSeats * plan.seatPrice;

  // Add usage overage
  const overage = Math.max(0, expectedUsage - plan.includedUsage);
  total += overage * plan.overageRate;

  // Add feature add-ons
  total += addons.reduce((sum, addon) => sum + addon.price, 0);

  return total;
}

وضوح الاستخدام

اعرض للعملاء استخدامهم في الوقت الفعلي:

// Display usage dashboard
async function getUsageSummary(subscriptionId: string) {
  const usage = await client.subscriptions.retrieveUsageHistory(subscriptionId);

  // Each item is a billing period; each meter reports its usage for that period.
  const latestPeriod = usage.items[0];

  return latestPeriod.meters.map((meter) => {
    const consumed = Number(meter.consumed_units);
    const chargeable = Number(meter.chargeable_units);
    return {
      meter: meter.name,
      current: consumed,
      included: meter.free_threshold,
      remaining: Math.max(0, meter.free_threshold - consumed),
      overage: chargeable,
      cost: meter.total_price
    };
  });
}

شفافية الفوترة

قدّم فواتير مفصلة توضح جميع المكوّنات:

بند الفاتورة	المبلغ
خطة Pro (شهريًا)	$49.00
المقاعد الإضافية (7 × $15.00)	$105.00
استخدام API - المضمن (10,000 استدعاء)	$0.00
استخدام API - الزائد (15,420 استدعاء × $0.005)	$77.10
إضافة التحليلات المتقدمة	$19.00
المجموع الفرعي	$250.10
الضريبة (8.5%)	$21.26
الإجمالي المستحق	$271.36

استكشاف أخطاء الفوترة الهجينة وإصلاحها

Usage not being tracked correctly

الأعراض: يظهر الاستخدام بقيمة 0 أو بقيم غير صحيحة.الحلول:

تحقّق من أن استيعاب الأحداث يعمل (تحقّق من استجابات API)
تأكد من أن customer_id يطابق عميل الاشتراك
تحقّق من أن event_name يطابق إعداد العداد
تحقّق من أن للأحداث طوابع زمنية صحيحة (وليست مؤرخة في المستقبل)

Proration confusion with multiple components

الأعراض: تم تحصيل مبالغ غير متوقعة من العميل عند تغيير الخطط.الحلول:

استخدم API ‏previewChangePlan لعرض الرسوم الدقيقة قبل التأكيد
وضّح أن التقسيط النسبي ينطبق على الاشتراك والإضافات
فكّر في استخدام difference_immediately لتبسيط فوترة الترقية

Free threshold not applying correctly

الأعراض: تم تحصيل رسوم من العميل مقابل استخدام يجب أن يكون مجانيًا.الحلول:

تحقّق من إعداد الحد المجاني على المنتج القائم على الاستخدام
تحقّق من تطابق وحدة الحد مع تجميع الأحداث (الاستدعاءات مقابل الطلبات)
تأكد من إرفاق عداد الاستخدام بمنتج الاشتراك بشكل صحيح

Add-ons not appearing in checkout

الأعراض: يتعذر إضافة المقاعد أو الميزات أثناء الدفع.الحلول:

تحقّق من إرفاق الإضافات بمنتج الاشتراك في لوحة المعلومات
تحقّق من صحة معرّفات الإضافات في استدعاءات API
تأكد من تطابق عملة الإضافة مع عملة منتج الاشتراك

الوثائق ذات الصلة

Products

نظرة عامة على جميع أنواع المنتجات والأدلة.

Usage-Based Billing Guide

تنفيذ كامل لفوترة الاستخدام.

Subscription Management

إدارة الاشتراكات المتكررة.

Add-ons

توسيع الاشتراكات باستخدام الإضافات.

آخر تعديل في ٦ أغسطس ٢٠٢٦

Usage-Based Billing

Subscriptions

Add-ons

Seat-Based Billing

​ما الفوترة الهجينة؟

​لماذا تستخدم الفوترة الهجينة؟

​الأنماط الهجينة الشائعة

​النموذج الهجين 1: الاشتراك + الاستخدام

​آلية العمل

​حالات الاستخدام

​التنفيذ

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

​النموذج الهجين 2: الاشتراك + المقاعد

​آلية العمل

​حالات الاستخدام

​التنفيذ

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

​النموذج الهجين 3: الاشتراك + إضافات الميزات

​آلية العمل

​حالات الاستخدام

​التنفيذ

​النموذج الهجين 4: المقاعد + الاستخدام

​كيف يعمل

​حالات الاستخدام

​خيارات التنفيذ

​النموذج الهجين 5: الاشتراك + المقاعد + الاستخدام (هجين ثلاثي)

​كيف يعمل

​حالات الاستخدام

​خيارات التنفيذ

​النموذج الهجين 6: الأساس المتدرج + الاستخدام الزائد

​كيف يعمل

​التنفيذ

​مسار الترقية

​النموذج الهجين 7: الاشتراك + الرسوم عند الطلب

​كيف يعمل

​حالات الاستخدام

​التنفيذ

​أمثلة من الواقع

​المثال 1: منصة AI SaaS

​المثال 2: منصة أدوات المطورين

​المثال 3: أتمتة التسويق

​أفضل ممارسات التنفيذ

​وضوح صفحة التسعير

​إمكانية التنبؤ بالتكلفة

​وضوح الاستخدام

​شفافية الفوترة

​استكشاف أخطاء الفوترة الهجينة وإصلاحها

​الوثائق ذات الصلة

Products

Usage-Based Billing Guide

Subscription Management

Add-ons

ما الفوترة الهجينة؟

لماذا تستخدم الفوترة الهجينة؟

الأنماط الهجينة الشائعة

النموذج الهجين 1: الاشتراك + الاستخدام

آلية العمل

حالات الاستخدام

التنفيذ

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

النموذج الهجين 2: الاشتراك + المقاعد

آلية العمل

حالات الاستخدام

التنفيذ

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

النموذج الهجين 3: الاشتراك + إضافات الميزات

آلية العمل

حالات الاستخدام

التنفيذ

النموذج الهجين 4: المقاعد + الاستخدام

كيف يعمل

حالات الاستخدام

خيارات التنفيذ

النموذج الهجين 5: الاشتراك + المقاعد + الاستخدام (هجين ثلاثي)

كيف يعمل

حالات الاستخدام

خيارات التنفيذ

النموذج الهجين 6: الأساس المتدرج + الاستخدام الزائد

كيف يعمل

التنفيذ

مسار الترقية

النموذج الهجين 7: الاشتراك + الرسوم عند الطلب

كيف يعمل

حالات الاستخدام

التنفيذ

أمثلة من الواقع

المثال 1: منصة AI SaaS

المثال 2: منصة أدوات المطورين

المثال 3: أتمتة التسويق

أفضل ممارسات التنفيذ

وضوح صفحة التسعير

إمكانية التنبؤ بالتكلفة

وضوح الاستخدام

شفافية الفوترة

استكشاف أخطاء الفوترة الهجينة وإصلاحها

الوثائق ذات الصلة