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

​

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

​

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

​

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

​

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

​

كيف يعمل

• المشمول: 10,000 طلب API/شهر
• الاستخدام الزائد: 0.005 دولار لكل طلب بعد 10,000

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

​

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

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

​

التنفيذ

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

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)

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

await fetch('https://api.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' }
    }]
  })
});

​

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

​

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

​

كيف يعمل

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

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

​

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

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

​

التنفيذ

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

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

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: '[email protected]' },
  return_url: 'https://yourapp.com/success'
});

// 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
  }]
});

​

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

​

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

​

كيف يعمل

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

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

​

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

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

​

التنفيذ

# 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

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

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

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

// 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: المقاعد + الاستخدام

​

كيف يعمل

• 5 جيجابايت معالجة بيانات/شهر
• الاستخدام الزائد: 2 دولار/جيجابايت بعد البدل

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

​

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

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

​

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

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

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)

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

// 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 };
}

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

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

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

Enable on-demand charging

// 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()
  });
}

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

​

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

​

كيف يعمل

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

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

​

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

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

​

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

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

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

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

Enable on-demand charging

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: '[email protected]' },
  return_url: 'https://yourapp.com/success'
});

// 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()
  });
}

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

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

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

// 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
}

await fetch('https://api.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()
    }]
  })
});

​

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

​

كيف يعمل

​

التنفيذ

# 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: الاشتراك + رسوم عند الطلب

​

كيف يعمل

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

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

• الاحتياطي: 199.00 دولار
• 3 ساعات استشارة إضافية: 450.00 دولار
• 1 دعم طارئ: 100.00 دولار
• الإجمالي: 749.00 دولار

​

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

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

​

التنفيذ

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

// 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.description}: $${payment.amount / 100}`);
});

​

أمثلة من العالم الحقيقي

​

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

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

​

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

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

​

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

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

​

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

​

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

​

توقع التكاليف

// 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.getUsageHistory(subscriptionId);

  return {
    current: usage.current_period_usage,
    included: usage.free_threshold,
    remaining: Math.max(0, usage.free_threshold - usage.current_period_usage),
    overage: Math.max(0, usage.current_period_usage - usage.free_threshold),
    projectedCost: calculateProjectedOverage(usage)
  };
}

​

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

​

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

​

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