> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Credit-Based Billing

> Issue, manage, and track credit entitlements across subscriptions, one-time products, and usage-based billing with rollover, overage, and expiration controls.

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/4RR3Yj3Qeuw" title="Credit-Based Billing Tutorial" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

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

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

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

تناسب الأرصدة في الحالات التالية:

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

<Frame caption="Credits appear as entitlements on your products and show in checkout, customer portal, and subscription details.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Checkout.png?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=21880df0e4b0b1a3cb8593dbeb8ae343" alt="صفحة الدفع تُظهر الرصيد المتضمن مع شراء المنتج" style={{ maxHeight: '500px', width: 'auto' }} width="1440" height="960" data-path="images/CBB/Checkout.png" />
</Frame>

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

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

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

<Tabs>
  <Tab title="Custom Unit">
    حدد الأرصدة في وحدتك الخاصة - الرموز، مكالمات API، ساعات حسابية، أو أي مقياس ذو قيمة لمنتجك. استخدم الوحدات المخصصة مع الدقة التي تحددها (0 إلى 3 منازل عشرية).

    **الأفضل لـ**: مكالمات API، رموز الذكاء الاصطناعي، ساعات الحساب، وحدات التخزين، الرسائل
  </Tab>

  <Tab title="Fiat Credits">
    تمثل الأرصدة قيمة نقدية فعلية (مثل، USD، EUR). يحصل العملاء على رصيد نقدي ينخفض عند استخدامهم لخدمتك بالأسعار التي تحددها.

    **الأفضل لـ**: أرصدة مسبقة الدفع، أرصدة ترويجية، تعويض عن الخدمة
  </Tab>
</Tabs>

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

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

<Steps>
  <Step title="Credits Issued">
    تُمنح الأرصدة عندما يشتري العميل منتجًا (اشتراك أو مرة واحدة) مع استحقاقات الائتمان المرفقة. بالنسبة للاشتراكات، تُعاد الأرصدة في كل دورة فوترة.
  </Step>

  <Step title="Credits Consumed">
    أثناء استخدام العملاء لخدمتك، تُخصم الأرصدة. للمنتجات القائمة على الاستخدام، تقوم العدادات تلقائيًا بخصم الأرصدة بناءً على الأحداث في الوقت الفعلي. يمكنك أيضًا خصم الأرصدة يدويًا عبر لوحة التحكم أو API.
  </Step>

  <Step title="Credits Expire or Roll Over">
    في نهاية دورة الفوترة (أو بعد فترة انتهاء الصلاحية المقررة)، تنتهي صلاحية الأرصدة غير المستخدمة أو تُرحل إلى الفترة التالية بناءً على إعداداتك.
  </Step>

  <Step title="Overage Handling">
    إذا نفدت الأرصدة في منتصف الدورة، يمكنك السماح بالتجاوز (الاستخدام المستمر بعد الرصيد) واختيار كيفية التعامل مع التجاوز - التسامح، الفوترة، أو ترحيل العجز للأمام.
  </Step>
</Steps>

### مصادر المنح

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

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

***

## إنشاء أرصدة

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

<Frame caption="The Credits tab under Products shows all your credit entitlements.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Entitlements%20%20-%20Credits.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=f9f30f473d342657d3f0f857e53b2e85" alt="صفحة قائمة الأرصدة تُظهر الاعتمادات المُنشأة" style={{ maxHeight: '500px', width: 'auto' }} width="3354" height="2004" data-path="images/CBB/Desktop - Entitlements  - Credits.jpg" />
</Frame>

<Steps>
  <Step title="Navigate to Credits">
    اذهب إلى **المنتجات** في لوحة التحكم واختر علامة التبويب **الأرصدة**. انقر على **إنشاء رصيد** للبدء.
  </Step>

  <Step title="Configure Basic Information">
    أدخل **اسم الرصيد** - هذا هو المعرف الداخلي لديك للرصيد.

    <Frame caption="The credit creation form with all configuration sections.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Create%20Credit.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=0c59e6b6eb4cfd76a545b39fb1f5c19e" alt="نموذج إنشاء الرصيد يُظهر المعلومات الأساسية والإعدادات العامة وإعدادات الاشتراك" style={{ maxHeight: '500px', width: 'auto' }} width="1919" height="954" data-path="images/CBB/Desktop - Create Credit.jpg" />
    </Frame>
  </Step>

  <Step title="Set General Settings">
    اضبط نوع الرصيد وخصائص العرض:

    <ParamField path="Credit Type" type="string" required>
      اختر **الوحدة المخصصة** أو **أرصدة العملة**.

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

    <ParamField path="Unit Name" type="string">
      فقط للأرصدة بوحدة مخصصة. يُظهر التصنيف الذي يراه العملاء لهذه الأرصدة (مثل، "رموز الذكاء الاصطناعي", "مكالمات API"). يظهر عند الفحص وفي بوابة العملاء.
    </ParamField>

    <ParamField path="Precision" type="number">
      فقط للأرصدة بوحدة مخصصة. عدد المنازل العشرية المسموح بها:

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

      <Warning>
        لا يمكن تغيير الدقة بعد إنشاء الرصيد.
      </Warning>
    </ParamField>

    <ParamField path="Credit Expiry" type="string">
      مدة صلاحية الأرصدة بعد إصدارها:

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

      اختر **مخصص** لتحديد عدد الأيام المخصص (الحد الأدنى 1).
    </ParamField>
  </Step>

  <Step title="Configure Subscription Settings (Optional)">
    هذه الإعدادات تتحكم في سلوك الأرصدة داخل الاشتراكات المتكررة:

    <ParamField path="Rollover" type="boolean">
      السماح بترحيل الأرصدة غير المستخدمة إلى دورة الفوترة التالية. عند التمكين، قم بتكوين:

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

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

    <ParamField path="Allow Overage" type="boolean">
      اسمح للعملاء بالاستمرار في استخدام خدمتك بعد أن يصل رصيدهم الائتماني إلى الصفر. عند التمكين، قم بتكوين:

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

    <ParamField path="Overage Behavior" type="string" required>
      يتحكم في كيفية التعامل مع التجاوز في نهاية دورة الفوترة:

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

  <Step title="Create Credit">
    انقر على **إنشاء رصيد** للحفظ. الرصيد الآن متاح للإرفاق بأي منتج.

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

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

***

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

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

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

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

<Steps>
  <Step title="Create or Edit a Subscription Product">
    انتقل إلى **المنتجات → إنشاء منتج** أو قم بتعديل منتج موجود. اختر **الاشتراك** كنوع التسعير وقم بإعداد السعر المتكر.
  </Step>

  <Step title="Open Entitlements Section">
    قم بتوسعة قسم **الاستحقاقات** وانقر على زر **إرفاق** بجوار **الأرصدة**.

    <Frame caption="The Entitlements section in the product form with Credits, License Key, and Digital Product Delivery options.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20Subscription.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=fb404b5c706ae200079742965a176605" alt="قسم حقوق المنتج يُظهر زر إرفاق الأرصدة" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Attach Credit - Subscription.jpg" />
    </Frame>
  </Step>

  <Step title="Select Credits to Attach">
    تفتح لوحة **إضافة أرصدة**. يمكنك اختيار رصيد موجود من القائمة المنسدلة أو النقر على **إنشاء رصيد جديد** لتعريف واحد على الفور.

    <Frame caption="The Add Credits panel lets you select existing credits or create new ones.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20Subscription-2.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=d67a2a18c7a550c8cf1e8378bd5514dc" alt="لوحة إضافة الأرصدة مع قائمة اختيار الأرصدة" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Attach Credit - Subscription-2.jpg" />
    </Frame>

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

  <Step title="Configure Credit Settings">
    لكل رصيد مرفق، قم بإعداد:

    <ParamField path="Credits issued per billing cycle" type="number" required>
      عدد الأرصدة الممنوحة للعميل في كل فترة فوترة.
    </ParamField>

    <ParamField path="Low Balance Threshold" type="number">
      الإشعار عند انخفاض الرصيد عن هذا المبلغ. مفيد لتنبيه العملاء قبل نفادهم.
    </ParamField>

    <ParamField path="Credits During Free Trial" type="number">
      تعيين مبلغ مختلف للرصيد لفترات التجربة. تمكين **انتهاء صلاحية أرصدة التجربة بعد انتهاء التجربة** لإلغاء الأرصدة غير المستخدمة عند التحويل إلى اشتراك مدفوع.
    </ParamField>

    <ParamField path="Allow Proration" type="boolean">
      تناسب الأرصدة المتبقية عند ترقية أو تخفيض خطة الاشتراك الخاصة بالعميل.
    </ParamField>

    <ParamField path="Import Default Credit Settings" type="boolean">
      استخدم افتراضات الترحيل، التجاوز، والانتهاء من استحقاق الرصيد. قم بإيقاف هذه الإعدادات لتخصيصها خصيصًا لهذا المنتج.
    </ParamField>

    <Frame caption="Credit configuration showing per-cycle amount, trial credits, proration, and custom settings.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20Subscription-4.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=68e212dddbec73131cf9f75bf5b55408" alt="نموذج تكوين الأرصدة مع إعدادات دورة الفوترة والتجربة والتوزيع" style={{ maxHeight: '500px', width: 'auto' }} width="1800" height="1842" data-path="images/CBB/Desktop - Attach Credit - Subscription-4.jpg" />
    </Frame>
  </Step>

  <Step title="Review and Add">
    راجع الرصيد المرفق الذي يظهر الاسم، الكمية، والانتهاء. انقر على **إضافة إلى الاشتراك** للتأكيد.

    <Frame caption="Review attached credits before adding them to the subscription.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20Subscription-5.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=7d8a21560061c15cc8544831a59793e2" alt="لوحة إضافة الأرصدة تُظهر الرصيد المُختار مع التفاصيل" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Attach Credit - Subscription-5.jpg" />
    </Frame>
  </Step>
</Steps>

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

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

<Steps>
  <Step title="Create a One-Time Product">
    أنشئ منتجًا بنوع التسعير **دفع فردي**.

    <Frame caption="Single Payment pricing selected for a one-time credit product.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20OTP.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=1743cb3e515952f9d4b1b2782cebac8b" alt="قسم تسعير المنتج مع اختيار الدفع الأحادي" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Attach Credit - OTP.jpg" />
    </Frame>
  </Step>

  <Step title="Attach Credits">
    افتح قسم **الاستحقاقات** وارفق الأرصدة. قم بتكوين **عدد الأرصدة المُصدرة** (الإجمالي لمرة واحدة) عند الشراء.
  </Step>
</Steps>

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

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

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

<Steps>
  <Step title="Create a Usage-Based Product">
    اختر **الفوترة القائمة على الاستخدام** كنوع التسعير. قم بإعداد السعر الأساسي وتكرار الفوترة.

    <Frame caption="Usage Based Billing pricing type with meter configuration.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=41b2862c12d126e7843098307e27e137" alt="تكوين تسعير الفوترة حسب الاستخدام" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Attach Credit - UBB.jpg" />
    </Frame>
  </Step>

  <Step title="Add a Meter">
    انقر على زر **+** في قسم **اختر العداد** لإضافة عداد. يمكن أن يحتوي الاشتراك على ما يصل إلى **3 عدادات**.

    <Frame caption="The Select Meter panel with meter configuration and credit toggle.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-3.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=3f677352783684107eaa7e568d9352e2" alt="لوحة اختيار العداد تُظهر الحد المجاني وتبديل الأرصدة" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Attach Credit - UBB-3.jpg" />
    </Frame>
  </Step>

  <Step title="Enable Credit Billing on the Meter">
    تفعيل **فوتر الاستهلاك بالأرصدة** لإرفاق رصيد بالعداد. اختر استحقاق الرصيد من القائمة المنسدلة.

    <ParamField path="Free Threshold" type="number" required>
      عدد الوحدات المجانية قبل أن تبدأ خصم الرصيد.
    </ParamField>

    <ParamField path="Bill usage in Credits" type="boolean">
      عند التمكين، يخصم عداد الاستخدام من رصيد العميل بدلاً من الشحن لكل وحدة.
    </ParamField>

    <ParamField path="Meter units per credit" type="number" required>
      عدد وحدات الاستخدام المطلوبة لخصم 1 رصيد. على سبيل المثال، إذا تم التعين على `1000`، فإن 1,000 مكالمة API تستهلك 1 رصيد.
    </ParamField>

    <Frame caption="Credit attached to a meter with per-unit conversion rate.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-5.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=b4ef2fe5079cbf3bb39eb3814f101cbd" alt="تكوين العداد مع اختيار الأرصدة ووحدات العداد لكل رصيد" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="2282" data-path="images/CBB/Desktop - Attach Credit - UBB-5.jpg" />
    </Frame>
  </Step>

  <Step title="Configure Credit Issuance">
    حدد عدد الأرصدة الصادرة وقم بتخصيص إعدادات الرصيد لهذا المنتج بشكل اختياري.

    <Frame caption="Configure how many credits to issue and whether to use default settings.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-6.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=22e99c54f11305a24d63c77e09a4650c" alt="تكوين الأرصدة لمنتج الفوترة حسب الاستخدام" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Attach Credit - UBB-6.jpg" />
    </Frame>
  </Step>

  <Step title="Verify Attachment">
    بمجرد التكوين، يظهر العداد اسم الرصيد المرفق، سعر الوحدة، والحد المجاني.

    <Frame caption="Meter with credit attached showing price, threshold, and credit name.">
      <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Attach%20Credit%20-%20UBB-1.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=d1a68ef9f07872b1dc9d2b2a655df0a4" alt="العداد المُكون يُظهر تفاصيل إرفاق الأرصدة" style={{ maxHeight: '500px', width: 'auto' }} width="3220" height="1830" data-path="images/CBB/Desktop - Attach Credit - UBB-1.jpg" />
    </Frame>
  </Step>
</Steps>

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

***

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

### الترحيل

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

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

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

### التجاوز

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

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

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

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

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

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

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

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

***

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

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

<Frame caption="The Usage Billing dashboard shows meter events with units consumed, credits consumed, and customer details.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Usage%20Billing.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=de8c5992d0ae59e74bbb8a840e07454f" alt="لوحة التحكم في الفوترة حسب الاستخدام تُظهر جدول الأحداث مع الأرصدة المستهلكة" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Usage Billing.jpg" />
</Frame>

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

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

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

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

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

***

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

### الفحص

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

<Frame caption="Checkout shows included credits with the product, making the value proposition clear.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Checkout.png?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=21880df0e4b0b1a3cb8593dbeb8ae343" alt="صفحة الخروج تُظهر المنتج مع أرصدة مكالمات API المُتضمنة" style={{ maxHeight: '500px', width: 'auto' }} width="1440" height="960" data-path="images/CBB/Checkout.png" />
</Frame>

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

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

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

<Frame caption="The Customer Portal shows available balance and full transaction history.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Customer%20Portal.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=b8afe1f89242f9e347b26b990dd00fe8" alt="عرض رصيد بوابة العميل مع الرصيد المتبقي وسجل المعاملات" style={{ maxHeight: '500px', width: 'auto' }} width="3016" height="2030" data-path="images/CBB/Customer Portal.jpg" />
</Frame>

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

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

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

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

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

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

<Frame caption="Subscription details show credit allocation, remaining balance, and renewal date.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Subscription%20Details.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=059f57f8996c1f514b9d7eba1ef6e33a" alt="صفحة تفاصيل الاشتراك تُظهر الحقوق وسجل الاستخدام" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1984" data-path="images/CBB/Desktop - Subscription Details.jpg" />
</Frame>

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

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

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

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

<Frame caption="Transaction details show credits alongside other entitlements like license keys and digital downloads.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Transactions%20-%20Payment%20Summary.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=dccb0ada7682ead4493baf71199a86fb" alt="صفحة تفاصيل المعاملة تُظهر حقوق الرصيد" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="2752" data-path="images/CBB/Desktop - Transactions - Payment Summary.jpg" />
</Frame>

***

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

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

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

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

<Frame caption="Credits listing with total count, creation button, and management actions.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Entitlements%20%20-%20Credits.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=f9f30f473d342657d3f0f857e53b2e85" alt="صفحة قائمة الأرصدة في قسم المنتجات" style={{ maxHeight: '500px', width: 'auto' }} width="3354" height="2004" data-path="images/CBB/Desktop - Entitlements  - Credits.jpg" />
</Frame>

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

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

<Frame caption="Customer detail page showing credit balance and full transaction ledger.">
  <img src="https://mintcdn.com/dodopayments/ibNfoFRyCIGyt3pO/images/CBB/Desktop%20-%20Customer%20Details.jpg?fit=max&auto=format&n=ibNfoFRyCIGyt3pO&q=85&s=a52e7e914338d698bf72498821f6a8b6" alt="صفحة تفاصيل العميل مع علامة التبويب الأرصدة تُظهر الرصيد والمعاملات" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/CBB/Desktop - Customer Details.jpg" />
</Frame>

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

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

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

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

<Steps>
  <Step title="Navigate to Customer">
    اذهب إلى **العملاء** واختر العميل.
  </Step>

  <Step title="Open Credits Tab">
    انقر على علامة تبويب **الأرصدة** واختر استحقاق الرصيد المناسب من محدد المحفظة.
  </Step>

  <Step title="Apply Credit or Debit">
    انقر على **تطبيق الائتمان/الخصم** لفتح واجهة التعديل.

    <ParamField path="Transaction Type" type="string" required>
      اختر **ائتمان** لإضافة الأرصدة أو **خصم** لإزالة الأرصدة من رصيد العميل.
    </ParamField>

    <ParamField path="Amount" type="number" required>
      عدد الأرصدة المراد إضافتها أو إزالتها.
    </ParamField>

    <ParamField path="Reason" type="string">
      شرح اختياري للتعديل (مثل، "تعويض الخدمة", "مكافأة ترويجية").
    </ParamField>
  </Step>

  <Step title="Confirm">
    راجع وطبق التعديل. يتم تحديث التغيير فورًا في رصيد العميل وسجله في دفتر الأستاذ الائتماني.

    <Check>
      التعديلات اليدوية تنشئ إدخال دفتر الأستاذ `ManualAdjustment` مع سجل تدقيق كامل.
    </Check>
  </Step>
</Steps>

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

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

| نوع المعاملة         | الوصف                                                           |
| -------------------- | --------------------------------------------------------------- |
| **الائتمان المضاف**  | الأرصدة الممنوحة (اشتراك، مرة واحدة، أو 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` تكوين العتبة والرصيد الحالي.

<Card title="Credit Webhook Payloads" icon="bell" href="/developer-resources/webhooks/intents/credit">
  عرض المخططات الكاملة للتحميل، أوصاف الحقول، وأمثلة التكامل لجميع أحداث webhook للرصيد.
</Card>

***

## إدارة API

<AccordionGroup>
  <Accordion title="Create Credit Entitlements">
    استخدم API لإنشاء استحقاقات الائتمان برمجيًا مع التحكم الكامل في الترحيل، التجاوز، وإعدادات الانتهاء.

    <CardGroup cols={2}>
      <Card title="Create Credit Entitlement" icon="plus" href="/api-reference/credit-entitlements/create-credit-entitlement">
        إنشاء استحقاق الائتمان جديد مع تكوين الترحيل، التجاوز، والانتهاء.
      </Card>

      <Card title="List Credit Entitlements" icon="list" href="/api-reference/credit-entitlements/list-credit-entitlements">
        استرجاع جميع استحقاقات الائتمان الخاصة بنشاطك التجاري.
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Manage Credit Entitlements">
    استرجاع، تحديث، أو حذف استحقاقات الائتمان. يمكن استعادة الاستحقاقات المحذوفة.

    <CardGroup cols={2}>
      <Card title="Get Credit Entitlement" icon="magnifying-glass" href="/api-reference/credit-entitlements/get-credit-entitlement">
        استرجاع استحقاق الائتمان معين بواسطة ID.
      </Card>

      <Card title="Update Credit Entitlement" icon="pen" href="/api-reference/credit-entitlements/update-credit-entitlement">
        تحديث الترحيل، التجاوز، الانتهاء، أو إعدادات أخرى.
      </Card>

      <Card title="Delete Credit Entitlement" icon="trash" href="/api-reference/credit-entitlements/delete-credit-entitlement">
        حذف استحقاق الائتمان بشكل ناعم.
      </Card>

      <Card title="Undelete Credit Entitlement" icon="rotate-left" href="/api-reference/credit-entitlements/undelete-credit-entitlement">
        استعادة استحقاق الائتمان الذي تم حذفه مسبقًا.
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Grant and Adjust Credits">
    منح الأرصدة مباشرة إلى رصيد العميل دون الحاجة إلى شراء، أو إنشاء إدخالات الخصم اليدوية لتعديلات الفوترة.

    <Card title="Create Ledger Entry" icon="plus" href="/api-reference/credit-entitlements/create-ledger-entry">
      ائتمان أو خصم رصيد العميل مع سجل تدقيق كامل ودعم تحقيق التعرفية.
    </Card>
  </Accordion>

  <Accordion title="Query Balances and Ledger">
    استرجاع الرصيد الحالي للعميل، سجل المنح، وسجل المعاملات الكامل لأي استحقاق ائتماني.

    <CardGroup cols={2}>
      <Card title="List Balances" icon="wallet" href="/api-reference/credit-entitlements/list-balances">
        عرض جميع الأرصدة الخاصة بالعميل لاستحقاق ائتماني.
      </Card>
    </CardGroup>
  </Accordion>
</AccordionGroup>

### مثال تكامل

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

```typescript theme={null}
import DodoPayments from 'dodopayments';

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

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

```typescript theme={null}
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'
});
```

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

```typescript theme={null}
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 }
  }]
});
```

***

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

<AccordionGroup>
  <Accordion title="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`
  </Accordion>

  <Accordion title="API Gateway">
    **هيكل التسعير:**

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

    **التكوين:**

    * نوع الائتمان: وحدة مخصصة ("مكالمات API")
    * الدقة: 0 (مكالمات كاملة)
    * الترحيل: معطل
    * التجاوز: خطط المطورين+ تسمح بالتجاوز (التسامح عند إعادة التعيين)، خطة المجاني تعطل التجاوز
    * العداد: `api.request` مع التجميع Count
  </Accordion>

  <Accordion title="Cloud Storage Service">
    **هيكل التسعير:**

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

    **التكوين:**

    * نوع الائتمان: وحدة مخصصة ("ساعة جيجابايت")
    * الدقة: 2 (منزلتان عشريتان)
    * الترحيل: 50% كحد أقصى، يُرحل مرة واحدة
    * التجاوز: ممكن مع حد 200%
    * العداد: `storage.usage` مع التجميع Sum
  </Accordion>
</AccordionGroup>

***

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

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

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