Credit-Based Billing - Dodo Payments Documentation

نظام الفوترة القائم على الائتمان يتيح لك منح العملاء رصيدًا من الأرصدة - مكالمات API، رموز، وحدات حسابية، أو أي مقياس مخصص - وتخصم من هذا الرصيد مع استهلاكهم لخدمتك. تعمل الأرصدة عبر جميع أنواع المنتجات: الاشتراكات، المشتريات لمرة واحدة، والفوترة القائمة على الاستخدام.

ما هو نظام الفوترة القائم على الائتمان؟

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

منصات الذكاء الاصطناعي وLLM: منح الرموز أو أرصدة التوليد لكل خطة
خدمات API: تخصيص أرصدة مكالمات API مع تسعير التجاوز
منصات البنية التحتية: إصدار ساعات حسابية أو أرصدة تخزين
خدمات الاتصال: توفير أرصدة الرسائل أو الدقائق لكل اشتراك
SaaS مع مستويات الاستهلاك: جمع الاستهلاك المدرج في مجموعات الأرصدة

صفحة الدفع تُظهر الرصيد المتضمن مع شراء المنتج — Credits appear as entitlements on your products and show in checkout, customer portal, and subscription details.

المفاهيم الأساسية

أنواع الأرصدة

عند إنشاء ائتمان، تختار بين نوعين:

Custom Unit
Fiat Credits

حدد الأرصدة في وحدتك الخاصة - الرموز، مكالمات API، ساعات حسابية، أو أي مقياس ذو قيمة لمنتجك. استخدم الوحدات المخصصة مع الدقة التي تحددها (0 إلى 3 منازل عشرية).الأفضل لـ: مكالمات API، رموز الذكاء الاصطناعي، ساعات الحساب، وحدات التخزين، الرسائل

دورة حياة الأرصدة

تتبع الأرصدة دورة حياة واضحة من الإصدار إلى الاستهلاك:

Credits Issued

تُمنح الأرصدة عندما يشتري العميل منتجًا (اشتراك أو مرة واحدة) مع استحقاقات الائتمان المرفقة. بالنسبة للاشتراكات، تُعاد الأرصدة في كل دورة فوترة.

Credits Consumed

أثناء استخدام العملاء لخدمتك، تُخصم الأرصدة. للمنتجات القائمة على الاستخدام، تقوم العدادات تلقائيًا بخصم الأرصدة بناءً على الأحداث في الوقت الفعلي. يمكنك أيضًا خصم الأرصدة يدويًا عبر لوحة التحكم أو API.

Credits Expire or Roll Over

في نهاية دورة الفوترة (أو بعد فترة انتهاء الصلاحية المقررة)، تنتهي صلاحية الأرصدة غير المستخدمة أو تُرحل إلى الفترة التالية بناءً على إعداداتك.

Overage Handling

إذا نفدت الأرصدة في منتصف الدورة، يمكنك السماح بالتجاوز (الاستخدام المستمر بعد الرصيد) واختيار كيفية التعامل مع التجاوز - التسامح، الفوترة، أو ترحيل العجز للأمام.

مصادر المنح

يمكن منح الأرصدة من مصادر متعددة:

المصدر	الوصف
الاشتراك	أرصدة تُصدر مع شراء الاشتراك، تُعاد إصدارها في كل دورة فوترة
لمرة واحدة	أرصدة تُصدر بمنتج دفع لمرة واحدة
API	أرصدة تُمنح يدويًا عبر API أو لوحة التحكم
الترحيل	أرصدة ترحلت من دورة فوترة سابقة

إنشاء أرصدة

أنشئ استحقاقات الأرصدة في قسم المنتجات → الأرصدة في لوحة التحكم الخاصة بك. يُعرّف كل رصيد الوحدة، الدقة، قواعد انتهاء الصلاحية، وسلوك دورة الحياة.

صفحة قائمة الأرصدة تُظهر الاعتمادات المُنشأة — The Credits tab under Products shows all your credit entitlements.

Navigate to Credits

اذهب إلى المنتجات في لوحة التحكم واختر علامة التبويب الأرصدة. انقر على إنشاء رصيد للبدء.

Configure Basic Information

أدخل اسم الرصيد - هذا هو المعرف الداخلي لديك للرصيد.

نموذج إنشاء الرصيد يُظهر المعلومات الأساسية والإعدادات العامة وإعدادات الاشتراك — The credit creation form with all configuration sections.

Set General Settings

اضبط نوع الرصيد وخصائص العرض:

string

مطلوب

اختر الوحدة المخصصة أو أرصدة العملة.

الوحدة المخصصة - تحديد المقياس الخاص بك (رموز، مكالمات API، ساعات حساب). يتطلب اسم الوحدة (مثل، “رموز المنصة”) وإعداد الدقة.
أرصدة العملة - تمثل الأرصدة قيمة نقدية فعلية. يتطلب اختيار وحدة العملة (USD، EUR، GBP، INR، إلخ).

string

فقط للأرصدة بوحدة مخصصة. يُظهر التصنيف الذي يراه العملاء لهذه الأرصدة (مثل، “رموز الذكاء الاصطناعي”, “مكالمات API”). يظهر عند الفحص وفي بوابة العملاء.

number

فقط للأرصدة بوحدة مخصصة. عدد المنازل العشرية المسموح بها:

0 - الأعداد الصحيحة (الأفضل للعناصر المعدودة مثل مكالمات API)
1 - منزلة عشرية واحدة (0.0)
2 - منزلتان عشريتان (0.00) - الافتراضي
3 - ثلاث منازل عشرية (0.000)

لا يمكن تغيير الدقة بعد إنشاء الرصيد.

string

مدة صلاحية الأرصدة بعد إصدارها:

7 أيام، 30 يومًا (افتراضي)، 60 يومًا، 90 يومًا، مخصص، أو أبدًا

اختر مخصص لتحديد عدد الأيام المخصص (الحد الأدنى 1).

Configure Subscription Settings (Optional)

هذه الإعدادات تتحكم في سلوك الأرصدة داخل الاشتراكات المتكررة:

boolean

السماح بترحيل الأرصدة غير المستخدمة إلى دورة الفوترة التالية. عند التمكين، قم بتكوين:

نسبة الترحيل القصوى (0–100%) - الحد من مقدار الترحيل
إطار زمني للترحيل - مدة صلاحية الأرصدة المرحلة (مثل، 1 شهر)
عدد مرات الترحيل الأقصى - الحد الأقصى للترحيلات المتتالية قبل فقدان الأرصدة

عندما تنفد الأرصدة أو ينتهي الاشتراك:

boolean

اسمح للعملاء بالاستمرار في استخدام خدمتك بعد أن يصل رصيدهم الائتماني إلى الصفر. عند التمكين، قم بتكوين:

حد التجاوز - الحد الأقصى للأرصدة التي يمكن للعملاء استهلاكها بالإضافة إلى رصيدهم
السعر لكل وحدة - تكلفة الرصيد الإضافي عندما يكون التجاوز ممكنًا (مع محدد العملة)

string

مطلوب

يتحكم في كيفية التعامل مع التجاوز في نهاية دورة الفوترة:

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

Create Credit

انقر على إنشاء رصيد للحفظ. الرصيد الآن متاح للإرفاق بأي منتج.

استحقاق رصيدك جاهز. قم بإرفاقه بالمنتجات للبدء في إصدار الأرصدة للعملاء.

ابدأ بإعدادات بسيطة - بدون ترحيل، بدون تجاوز - وأضف التعقيد كلما تعلمت كيف يستخدم العملاء الأرصدة. يمكن تحديث معظم الإعدادات في أي وقت دون التأثير على المنح الحالية. لاحظ أنه لا يمكن تغيير الدقة بعد إنشاء الرصيد.

إرفاق الأرصدة بالمنتجات

يتم إرفاق النقاط بالمنتجات كـ حقوق في عملية إنشاء أو تحرير المنتج. يمكنك إرفاق ما يصل إلى 5 نقاط لكل منتج. تعمل النقاط مع جميع أنواع التسعير الثلاثة.

منتجات الاشتراك

بالنسبة للاشتراكات، تُصدر الأرصدة لكل دورة فوترة ويمكن إعدادها بالبرورطة، وأرصدة التجربة، وإعدادات الدورة المحددة.

Create or Edit a Subscription Product

انتقل إلى المنتجات → إنشاء منتج أو قم بتعديل منتج موجود. اختر الاشتراك كنوع التسعير وقم بإعداد السعر المتكر.

Open Entitlements Section

قم بتوسعة قسم الاستحقاقات وانقر على زر إرفاق بجوار الأرصدة.

قسم حقوق المنتج يُظهر زر إرفاق الأرصدة — The Entitlements section in the product form with Credits, License Key, and Digital Product Delivery options.

Select Credits to Attach

تفتح لوحة إضافة أرصدة. يمكنك اختيار رصيد موجود من القائمة المنسدلة أو النقر على إنشاء رصيد جديد لتعريف واحد على الفور.

لوحة إضافة الأرصدة مع قائمة اختيار الأرصدة — The Add Credits panel lets you select existing credits or create new ones.

يمكنك إرفاق ما يصل إلى 5 نقاط لكل منتج. يمكن أن يكون لكل نقطة تكوينها الخاص.

Configure Credit Settings

لكل رصيد مرفق، قم بإعداد:

number

مطلوب

عدد الأرصدة الممنوحة للعميل في كل فترة فوترة.

number

الإشعار عند انخفاض الرصيد عن هذا المبلغ. مفيد لتنبيه العملاء قبل نفادهم.

number

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

boolean

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

boolean

استخدم افتراضات الترحيل، التجاوز، والانتهاء من استحقاق الرصيد. قم بإيقاف هذه الإعدادات لتخصيصها خصيصًا لهذا المنتج.

نموذج تكوين الأرصدة مع إعدادات دورة الفوترة والتجربة والتوزيع — Credit configuration showing per-cycle amount, trial credits, proration, and custom settings.

Review and Add

راجع الرصيد المرفق الذي يظهر الاسم، الكمية، والانتهاء. انقر على إضافة إلى الاشتراك للتأكيد.

لوحة إضافة الأرصدة تُظهر الرصيد المُختار مع التفاصيل — Review attached credits before adding them to the subscription.

منتجات الدفع لمرة واحدة

بالنسبة للمدفوعات لمرة واحدة، تُصدر الأرصدة مرة واحدة في وقت الشراء.

Create a One-Time Product

أنشئ منتجًا بنوع التسعير دفع فردي.

قسم تسعير المنتج مع اختيار الدفع الأحادي — Single Payment pricing selected for a one-time credit product.

Attach Credits

افتح قسم الاستحقاقات وارفق الأرصدة. قم بتكوين عدد الأرصدة المُصدرة (الإجمالي لمرة واحدة) عند الشراء.

الأرصدة للمنتجات لمرة واحدة مثالية لحزم تزويد الرصيد، الحزم الترويجية، أو مشتريات الرصيد المسبق.

منتجات الفوترة القائمة على الاستخدام

بالنسبة للمنتجات القائمة على الاستخدام، ترتبط الأرصدة بـ عدادات وتُخصم تلقائيًا بناءً على أحداث الاستهلاك في الوقت الفعلي.

Create a Usage-Based Product

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

تكوين تسعير الفوترة حسب الاستخدام — Usage Based Billing pricing type with meter configuration.

Add a Meter

انقر على زر + في قسم اختر العداد لإضافة عداد. يمكن أن يحتوي الاشتراك على ما يصل إلى 3 عدادات.

لوحة اختيار العداد تُظهر الحد المجاني وتبديل الأرصدة — The Select Meter panel with meter configuration and credit toggle.

Enable Credit Billing on the Meter

تفعيل فوتر الاستهلاك بالأرصدة لإرفاق رصيد بالعداد. اختر استحقاق الرصيد من القائمة المنسدلة.

number

مطلوب

عدد الوحدات المجانية قبل أن تبدأ خصم الرصيد.

boolean

عند التمكين، يخصم عداد الاستخدام من رصيد العميل بدلاً من الشحن لكل وحدة.

number

مطلوب

عدد وحدات الاستخدام المطلوبة لخصم 1 رصيد. على سبيل المثال، إذا تم التعين على 1000، فإن 1,000 مكالمة API تستهلك 1 رصيد.

تكوين العداد مع اختيار الأرصدة ووحدات العداد لكل رصيد — Credit attached to a meter with per-unit conversion rate.

Configure Credit Issuance

حدد عدد الأرصدة الصادرة وقم بتخصيص إعدادات الرصيد لهذا المنتج بشكل اختياري.

تكوين الأرصدة لمنتج الفوترة حسب الاستخدام — Configure how many credits to issue and whether to use default settings.

Verify Attachment

بمجرد التكوين، يظهر العداد اسم الرصيد المرفق، سعر الوحدة، والحد المجاني.

العداد المُكون يُظهر تفاصيل إرفاق الأرصدة — Meter with credit attached showing price, threshold, and credit name.

عندما تكون الأرصدة مرتبطة بالعدادات، يقوم النظام تلقائيًا بخصم الأرصدة بناءً على أحداث الاستخدام الملتقطة. يقوم عامل خلفية بمعالجة الأحداث كل دقيقة، ويجمعها وفقًا لتكوين العداد، ويطبق الخصم وفقًا لأولهم خروجًا (FIFO) من المنح الأقدم غير المنتهية للعميل.

إعدادات الرصيد

الترحيل

يتيح الترحيل للأرصدة غير المستخدمة الترحيل إلى دورة الفوترة التالية بدلاً من انتهائها.

الإعداد	الوصف
الترحيل ممكن	تبديل للسماح بترحيل الأرصدة غير المستخدمة
نسبة الترحيل القصوى	الحد من مقدار الترحيل (0–100%). إذا كانت 50%، يترحل النصف فقط من الأرصدة غير المستخدمة
إطار زمني للترحيل	مدة صلاحية الأرصدة المرحلة (يوم، أسبوع، شهر، سنة)
عدد مرات الترحيل الأقصى	عدد المرات القصوى التي يمكن ترحيل الأرصدة فيها بشكل متتال. بعد هذا الحد، تفقد الأرصدة المتبقية

مثال: لدى العميل 200 رصيد غير مستخدم في نهاية الدورة. مع ترحيل 75%، يترحل 150 رصيدًا ويفقد 50.

التجاوز

يتحكم التجاوز في ما يحدث عندما يصل رصيد العميل الائتماني إلى الصفر خلال الدورة.

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

خيارات سلوك التجاوز:

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

عند تعطيل التجاوز، لا يمكن للعملاء استخدام الخدمة عند نفاد رصيدهم الائتماني. اختر سلوك التجاوز الذي يتناسب مع نموذج الفوترة الخاص بك - اعفاء عند إعادة التعيين هو الخيار الافتراضي والأبسط.

انتهاء الصلاحية

الإعداد	الوصف
انتهاء صلاحية الرصيد	المدة بعد الإصدار قبل انتهاء الأرصدة (7، 30، 60، 90، أيام مخصصة، أو أبدًا)
انتهاء صلاحية أرصدة التجربة بعد التجربة	ما إذا كانت الأرصدة المحددة للتجربة تنتهي عند انتهاء فترة التجربة

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

فوترة الاستخدام مع الأرصدة

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

لوحة التحكم في الفوترة حسب الاستخدام تُظهر جدول الأحداث مع الأرصدة المستهلكة — The Usage Billing dashboard shows meter events with units consumed, credits consumed, and customer details.

كيف يعمل خصم الرصيد بناءً على العداد

تطبيقك يرسل أحداث الاستخدام - كل حدث يتضمن معرف العميل، اسم الحدث، وبيانات إضافية
المقاييس تجمع الأحداث - باستخدام التجميع بعدد، مجموع، أعلى قيمة، أو آخر قيمة
يتم خصم النقاط تلقائيًا - يعمل عامل خلفي على معالجة الأحداث كل دقيقة، يحول وحدات المقاييس إلى نقاط باستخدام المعدل الذي قمت بتكوينه، ويخصم من رصيد العميل باستخدام ترتيب FIFO (المنح الأقدم أولاً)
يتم تتبع التجاوز - إذا وصل رصيد النقاط إلى الصفر وتم تفعيل التجاوز، يقوم النظام بتتبع استخدام التجاوز للفوترة نهاية الدورة

لوحة العدادات

تتضمن لوحة فوترة الاستخدام لوحة العدادات التي تعرض جميع العدادات المعرفة مع نوع التجميع الخاص بها:

التجميع	الوصف	المثال
العدد	العدد الكلي للأحداث	استدعاءات API
المجموع	مجموع حقل القيمة	إجمالي البايتات المنقولة
الأعلى	أعلى قيمة مسجلة	أقصى عدد مستخدمين متزامنين
الأخير	أحدث قيمة	التخزين الحالي المستخدم

تجربة العملاء

الفحص

عندما يشتري العميل منتجًا مع الأرصدة المرفقة، تعرض صفحة الفحص الأرصدة المدرجة كجزء من عرض المنتج.

صفحة الخروج تُظهر المنتج مع أرصدة مكالمات API المُتضمنة — Checkout shows included credits with the product, making the value proposition clear.

تظهر الأرصدة في قسم تشمل تحت وصف المنتج، تعرض مبلغ الرصيد والنوع (مثل، “$1000 مكالمات API”).

بوابة العملاء

يمكن للعملاء عرض وإدارة أرصدتهم في بوابة العملاء تحت قسم الأرصدة.

عرض رصيد بوابة العميل مع الرصيد المتبقي وسجل المعاملات — The Customer Portal shows available balance and full transaction history.

تعرض البوابة:

الرصيد المتاح - الرصيد الحالي معروض بوضوح
علامات التبويب للأرصدة - التبديل بين أنواع الأرصدة المختلفة (مثل، “أرصدة OpenAI”, “رموز الاستخدام”)
المعاملات الأخيرة - سجل كامل بالتاريخ، معرف المعاملة، النوع، المبلغ، والرصيد الجاري

أنواع المعاملات المعروضة للعملاء تتضمن:

النوع	الوصف	المبلغ
أرصدة مع الاشتراك	الأرصدة الصادرة مع شراء/تجديد الاشتراك	أخضر (+)
أرصدة لمرة واحدة	الأرصدة من المشتريات لمرة واحدة أو المنح اليدوية	أخضر (+)
خصم الاستخدام	الأرصدة المستهلكة عبر استخدام الخدمة	أحمر (-)
التجاوز	الاستخدام بعد نفاد الرصيد الائتماني	أحمر (-)

تفاصيل الاشتراك

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

المعلومات الأساسية المعروضة:

تخصيص الرصيد لكل دورة فوترة (مثل، “1000 أرصدة لكل دورة”)
الرصيد المتبقي (مثل، “7500 أرصدة متبقية”)
تاريخ التجديد لإصدار الرصيد القادم
تبويب سجل الاستخدام مع توزيع مستوى العداد يظهر الوحدات المستهلكة، العتبات، أسعار الوحدات، والتكاليف الإجمالية

تفاصيل المعاملة

تشمل صفحات المعاملات المالية قسم الاستحقاقات الذي يعرض جميع الاستحقاقات المقدمة مع الدفع، بما في ذلك الأرصدة.

إدارة الأرصدة

عرض لوحة التحكم

قائمة استحقاقات الأرصدة

عرض جميع استحقاقات الأرصدة في المنتجات → الأرصدة. تعرض الجدول اسم الرصيد، إعدادات الانتهاء، وتوفر إجراءات سريعة للتعديل أو الأرشيف.

صفحة قائمة الأرصدة في قسم المنتجات — Credits listing with total count, creation button, and management actions.

تفاصيل الأرصدة للعملاء

عرض أرصدة العميل الواحدة والتاريخ المعاملات من العملاء → [اسم العميل] → الأرصدة.

صفحة تفاصيل العميل مع علامة التبويب الأرصدة تُظهر الرصيد والمعاملات — Customer detail page showing credit balance and full transaction ledger.

يتضمن عرض الأرصدة للعملاء:

محدد الرصيد - التبديل بين استحقاقات الائتمان المختلفة
الرصيد المتاح - الرصيد الحالي ظاهر بوضوح، عرض بارز
تطبيق الائتمان/الخصم - زر لتعديل رصيد العميل يدويًا
المعاملات الأخيرة - دفتر الأستاذ الكامل مع التاريخ، معرف المعاملة، النوع، المبلغ، والرصيد الجاري

التعديلات اليدوية

يمكنك إضافة أو خصم رصيد العميل يدويًا مباشرة من لوحة التحكم:

Navigate to Customer

اذهب إلى العملاء واختر العميل.

Open Credits Tab

انقر على علامة تبويب الأرصدة واختر استحقاق الرصيد المناسب من محدد المحفظة.

Apply Credit or Debit

انقر على تطبيق الائتمان/الخصم لفتح واجهة التعديل.

string

مطلوب

اختر ائتمان لإضافة الأرصدة أو خصم لإزالة الأرصدة من رصيد العميل.

number

مطلوب

عدد الأرصدة المراد إضافتها أو إزالتها.

string

شرح اختياري للتعديل (مثل، “تعويض الخدمة”, “مكافأة ترويجية”).

Confirm

راجع وطبق التعديل. يتم تحديث التغيير فورًا في رصيد العميل وسجله في دفتر الأستاذ الائتماني.

التعديلات اليدوية تنشئ إدخال دفتر الأستاذ ManualAdjustment مع سجل تدقيق كامل.

دفتر الأستاذ الائتماني

يتم تسجيل كل عملية ائتمانية في دفتر الأستاذ الائتماني، مما يوفر سجل تدقيق كامل:

نوع المعاملة	الوصف
الائتمان المضاف	الأرصدة الممنوحة (اشتراك، مرة واحدة، أو API)
الائتمان المخصوم	الأرصدة المستهلكة عبر الاستخدام أو الخصم اليدوي
الائتمان المنتهي	الأرصدة التي انتهت دون ترحيل
الائتمان المرحلة	الأرصدة المرحلة إلى الفترة التالية
الترحيل المفقود	الأرصدة المرحلة المفقودة بعد الوصول إلى عدد مرات الترحيل القصوى
التجاوز المشحون	الاستخدام بعد نفاد الرصيد الائتماني مع تمكين التجاوز
التزويد التلقائي	إعادة تعبئة الرصيد تلقائيًا عند انخفاض الرصيد
تعديل يدوي	ائتمان أو خصم مطبق يدويًا من قبل التاجر
استرداد	الأرصدة المستردة

يقوم كل إدخال في دفتر الأستاذ بتسجيل الرصيد قبل وبعد المعاملة، التجاوز قبل وبعد، وصف، وإشارة إلى المصدر (دفعة، اشتراك، إلخ).

Webhooks

يُطلق النظام القائم على الفوترة الائتمانية أحداث webhook عند كل تغيير في دورة حياة الائتمان. استخدم هذه للحفاظ على تزامن تطبيقك مع أرصدة الائتمانية، إطلاق الإشعارات، أو بناء سيناريوهات فوترة مخصصة.

الحدث	الوصف
`credit.added`	الأرصدة الممنوحة للعميل
`credit.deducted`	الأرصدة المستهلكة عبر الاستخدام أو الخصم اليدوي
`credit.expired`	الأرصدة غير المستخدمة المنتهية
`credit.rolled_over`	الأرصدة المرحلة لمنحة جديدة
`credit.rollover_forfeited`	الأرصدة المفقودة عند الوصول إلى عدد مرات الترحيل القصوى
`credit.overage_charged`	تطبيق رسوم التجاوز
`credit.manual_adjustment`	تعديل ائتمان/خصم يدوي
`credit.balance_low`	الرصيد انخفض إلى أدنى من النسبة المحددة

تتضمن جميع أحداث دفتر الأستاذ (credit.added إلى credit.manual_adjustment) حمولة كاملة CreditLedgerEntry مع الرصيد قبل/بعد، الفائض قبل/بعد، مرجع المصدر، وmetadata من اشتراك أو دفعة مصدر المنحة (فارغ للمنح التي تم إنشاؤها مباشرة عبر API). يتضمن حدث credit.balance_low تكوين العتبة والرصيد الحالي.

Credit Webhook Payloads

عرض المخططات الكاملة للتحميل، أوصاف الحقول، وأمثلة التكامل لجميع أحداث webhook للرصيد.

إدارة API

Create Credit Entitlements

استخدم API لإنشاء استحقاقات الائتمان برمجيًا مع التحكم الكامل في الترحيل، التجاوز، وإعدادات الانتهاء.

Create Credit Entitlement

إنشاء استحقاق الائتمان جديد مع تكوين الترحيل، التجاوز، والانتهاء.

List Credit Entitlements

استرجاع جميع استحقاقات الائتمان الخاصة بنشاطك التجاري.

Manage Credit Entitlements

استرجاع، تحديث، أو حذف استحقاقات الائتمان. يمكن استعادة الاستحقاقات المحذوفة.

Get Credit Entitlement

استرجاع استحقاق الائتمان معين بواسطة ID.

Update Credit Entitlement

تحديث الترحيل، التجاوز، الانتهاء، أو إعدادات أخرى.

Delete Credit Entitlement

حذف استحقاق الائتمان بشكل ناعم.

Undelete Credit Entitlement

استعادة استحقاق الائتمان الذي تم حذفه مسبقًا.

Grant and Adjust Credits

منح الأرصدة مباشرة إلى رصيد العميل دون الحاجة إلى شراء، أو إنشاء إدخالات الخصم اليدوية لتعديلات الفوترة.

Create Ledger Entry

ائتمان أو خصم رصيد العميل مع سجل تدقيق كامل ودعم تحقيق التعرفية.

Query Balances and Ledger

استرجاع الرصيد الحالي للعميل، سجل المنح، وسجل المعاملات الكامل لأي استحقاق ائتماني.

List Balances

عرض جميع الأرصدة الخاصة بالعميل لاستحقاق ائتماني.

مثال تكامل

تهيئة عميل Dodo Payments:

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

إرفاق الأرصدة بمنتج اشتراك أثناء الفحص:

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

إرسال أحداث الاستخدام التي تخصم الأرصدة تلقائيًا:

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

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

AI SaaS Platform

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

الخطة	السعر	أرصدة/شهر	تجاوز
للمبتدئين	$29/شهريًا	10,000 رموز	$0.003/رمز
محترف	$99/شهريًا	100,000 رموز	$0.002/رمز
الشركات	$499/شهريًا	1,000,000 رموز	$0.001/رمز

التكوين:

نوع الائتمان: وحدة مخصصة (“رموز AI”)
الدقة: 0 (رموز كاملة)
الترحيل: 25% كحد أقصى، إطار زمني 1 شهر
التجاوز: ممكن، فوترة تجاوز في الفوترة
العداد: ai.generation مع التجميع Sum على حقل tokens

API Gateway

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

الخطة	السعر	أرصدة/شهر	تجاوز
مجاني	$0/شهريًا	1,000 مكالمات	محظور
المطور	$19/شهريًا	50,000 مكالمات	$0.001/مكالمة
الأعمال	$99/شهريًا	500,000 مكالمات	$0.0005/مكالمة

التكوين:

نوع الائتمان: وحدة مخصصة (“مكالمات API”)
الدقة: 0 (مكالمات كاملة)
الترحيل: معطل
التجاوز: خطط المطورين+ تسمح بالتجاوز (التسامح عند إعادة التعيين)، خطة المجاني تعطل التجاوز
العداد: api.request مع التجميع Count

Cloud Storage Service

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

الخطة	السعر	أرصدة/شهر	تجاوز
شخصي	$9/شهريًا	100 ساعة جيجابايت	$0.05/ساعة جيجابايت
فريق	$49/شهريًا	1,000 ساعة جيجابايت	$0.03/ساعة جيجابايت

التكوين:

نوع الائتمان: وحدة مخصصة (“ساعة جيجابايت”)
الدقة: 2 (منزلتان عشريتان)
الترحيل: 50% كحد أقصى، يُرحل مرة واحدة
التجاوز: ممكن مع حد 200%
العداد: storage.usage مع التجميع Sum

أفضل الممارسات

ابدأ ببساطة: ابدأ بنوع واحد من الرصيد وبدون الترحيل. أضف التعقيد استنادًا إلى ملاحظات واستخدام العملاء.
حدد التوقعات بوضوح: عرض تخصيصات الرصيد، الأرصدة المتبقية، وتسعير التجاوز بشكل بارز في صفحات المنتجات الخاصة بك وبوابة العملاء.
استخدم وحدات ذات معنى: سمِّ الأرصدة بما تمثله (مثل، “مكالمات API”, “رموز AI”) بدلاً من المصطلحات العامة. يساعد ذلك العملاء على فهم القيمة.
قم بتكوين الانتهاء بعناية: قد تدفع نوافذ الانتهاء القصيرة (7 أيام) للسرعة ولكن قد تحبط العملاء. النوافذ الأطول (30–90 يومًا) أكثر موافقة للعملاء لمعظم منتجات SaaS.
مراقبة الأرصدة المنخفضة: ضع حدودًا منخفضة الرصيد لتنبيه العملاء قبل نفادها، مما يقلل من مفاجئات رسوم التجاوز.
اختبار في وضع الاختبار: إنشاء أرصدة، إرفاقها بمنتجات اختبار، وتجربة دورة الشراء الكاملة → الاستخدام → الخصم → الانتهاء قبل بدء التنفيذ.

يعمل النظام القائم على الفوترة الائتمانية بسلاسة مع جميع ميزات دافعات Dodo الأخرى - الاشتراكات مع الفترات التجريبية، تغييرات الخطة مع البرورطة، وبوابة العملاء. ابدأ بإعداد بسيط ووسّع كلما تطور نموذج التسعير الخاص بك.

آخر تعديل في ٢٦ يونيو ٢٠٢٦

الفوترة المعتمدة على المقاعدقم بتنفيذ تسعير لكل مستخدم لبرامج الفريق، ومنتجات SaaS، والتراخيص المؤسسية مع إدارة مقاعد مرنة وتقسيم الأسعار.

​ما هو نظام الفوترة القائم على الائتمان؟

​المفاهيم الأساسية

​أنواع الأرصدة

​دورة حياة الأرصدة

​مصادر المنح

​إنشاء أرصدة

​إرفاق الأرصدة بالمنتجات

​منتجات الاشتراك

​منتجات الدفع لمرة واحدة

​منتجات الفوترة القائمة على الاستخدام

​إعدادات الرصيد

​الترحيل

​التجاوز

​انتهاء الصلاحية

​فوترة الاستخدام مع الأرصدة

​كيف يعمل خصم الرصيد بناءً على العداد

​لوحة العدادات

​تجربة العملاء

​الفحص

​بوابة العملاء

​تفاصيل الاشتراك

​تفاصيل المعاملة

​إدارة الأرصدة

​عرض لوحة التحكم

​قائمة استحقاقات الأرصدة

​تفاصيل الأرصدة للعملاء

​التعديلات اليدوية

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

​Webhooks

Credit Webhook Payloads

​إدارة API

Create Credit Entitlement

List Credit Entitlements

Get Credit Entitlement

Update Credit Entitlement

Delete Credit Entitlement

Undelete Credit Entitlement

Create Ledger Entry

List Balances

​مثال تكامل

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

​أفضل الممارسات

ما هو نظام الفوترة القائم على الائتمان؟

المفاهيم الأساسية

أنواع الأرصدة

دورة حياة الأرصدة

مصادر المنح

إنشاء أرصدة

إرفاق الأرصدة بالمنتجات

منتجات الاشتراك

منتجات الدفع لمرة واحدة

منتجات الفوترة القائمة على الاستخدام

إعدادات الرصيد

الترحيل

التجاوز

انتهاء الصلاحية

فوترة الاستخدام مع الأرصدة

كيف يعمل خصم الرصيد بناءً على العداد

لوحة العدادات

تجربة العملاء

الفحص

بوابة العملاء

تفاصيل الاشتراك

تفاصيل المعاملة

إدارة الأرصدة

عرض لوحة التحكم

قائمة استحقاقات الأرصدة

تفاصيل الأرصدة للعملاء

التعديلات اليدوية

دفتر الأستاذ الائتماني

Webhooks

إدارة API

مثال تكامل

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

أفضل الممارسات