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

# نظام الفوترة

> تسعير الدفع حسب الاستخدام، ومستويات الخطط، وإدارة الاستخدام لمؤسسة Truthlocks الخاصة بك.

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

## مستويات الخطة

* **مُركز على المستأجر**: لكل مستأجر (مؤسسة) اشتراكه ودورة فواتيره الخاصة.
* **الاستحقاقات**: يتم فرض الميزات والحصص بناءً على مفتاح الخطة النشط (`plan_developer`، `plan_starter`، `plan_business`، `plan_institutional`، `plan_enterprise`).
* **متعددة المزودين**: نقوم بتوجيه المدفوعات عبر بوابات مختلفة (Stripe، Paystack، Flutterwave) اعتمادًا على الولاية القضائية القانونية للمستأجر.
* **التسعير الإقليمي**: يستخدم الدفع تلقائيًا بلد حسابك لتطبيق الأسعار والعملة الإقليمية الصحيحة. راجع [توجيه المزود](https://docs.truthlocks.com/ar/billing/provider-routing.md) للحصول على التفاصيل.

## مستويات الخطة

> [card] المطور
>
> للهواة ومشاريع إثبات المفهوم. يتضمن التحقق عبر الإنترنت ودعم المجتمع بدون تكلفة.

> [card] مبتدئ
>
> للشركات الصغيرة والمتوسطة والشركات الناشئة ذات أعباء العمل الإنتاجية. حصص أعلى، وما يصل إلى 3 نقاط نهاية webhook، ومعالجة ذات أولوية.

> [card] الأعمال
>
> لفرق السوق المتوسطة ذات احتياجات الامتثال. SAML SSO، وتوفير SCIM، و RBAC كامل وسجلات التدقيق، وما يصل إلى 10 نقاط نهاية webhook، واتفاقية مستوى خدمة للدعم لمدة 4 ساعات.

> [card] مؤسسي
>
> للمؤسسات الكبيرة ذات الاحتياجات الأمنية المتقدمة. سجل شفافية خاص، وتكامل HSM، واتفاقية مستوى خدمة للدعم لمدة ساعة واحدة.

> [card] المؤسسات
>
> تسعير مخصص للحكومات وشركات Fortune 500. اتفاقية مستوى خدمة مخصصة، وخيارات نشر داخلية، ودعم على مدار الساعة طوال أيام الأسبوع، وتأهيل مخصص.

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

* **الاستحقاقات** - تفتح كل خطة ميزات وحصصًا محددة (حدود السك، عدد عمليات التحقق، المقاعد، التخزين، حدود معدل API). يفرض خدمة الفوترة هذه الحدود على طبقة API.
* **عدادات الاستخدام** — يتم الإبلاغ عن العدادات المتاحة لدورة الفوترة المحددة. يمكنك مراقبة استهلاكك من لوحة معلومات استخدام وحدة التحكم أو [واجهة برمجة تطبيقات الاستخدام](https://docs.truthlocks.com/ar/api-reference/billing/usage.md).
* **توجيه متعدد المزودين** — تتم معالجة المدفوعات عبر البوابة المثلى لمنطقتك. راجع [توجيه المزود](https://docs.truthlocks.com/ar/billing/provider-routing.md) للحصول على التفاصيل.

## المنتجات المقاسة

تقيس Truthlocks 16 منتجًا منظمة في أربع فئات. يمكنك رؤيتها جميعًا في [صفحة الأسعار](https://www.truthlocks.com/pricing) وتتبع استهلاكك في وحدة التحكم ضمن **الإعدادات > الفوترة > الاستخدام**.

### الأساسية

| المنتج | الوصف | المعدل الافتراضي |
| :- | :- | :- |
| سك التصديقات | التصديقات التي تم إنشاؤها عبر API أو SDK | 0.25 دولار لكل سك |
| التحققات | طلبات التحقق من الإثبات | 0.10 دولار لكل عملية تحقق |
| التخزين | إجمالي مساحة تخزين الملفات والأدلة المستهلكة | متضمنة لكل خطة |
| حزم الإثبات | حزم الإثبات المشفرة التي تم إنشاؤها | متضمنة لكل خطة |
| نقاط نهاية Webhook | تسجيلات نقاط نهاية Webhook النشطة | متضمنة لكل خطة |
| تسليمات Webhook | محاولات تسليم Webhook الفردية | متضمنة لكل خطة |
| المقاعد | مقاعد أعضاء الفريق في مؤسستك | متضمنة لكل خطة |

### MAIP (هوية الجهاز)

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

### الذكاء الاصطناعي

| المنتج | الوصف | المعدل الافتراضي |
| :- | :- | :- |
| شهادات مجموعة البيانات | مجموعات البيانات المصدقة لتتبع النسب | حسب مستوى الخطة |
| شهادات النموذج | نماذج التعلم الآلي المعتمدة للمصدر | حسب مستوى الخطة |

### مكافحة الاحتيال

| المنتج | الوصف | المعدل الافتراضي |
| :- | :- | :- |
| إشارات المخاطر | إشارات الاحتيال المستوعبة أو المولدة | حسب مستوى الخطة |
| مسح التزييف العميق | طلبات مسح التزييف العميق وانتحال الشخصية | حسب مستوى الخطة |
| سجلات السرعة | سجلات إجراءات تسجيل السرعة | حسب مستوى الخطة |

> [!NOTE]
>
> استخدم [صفحة التسعير](https://www.truthlocks.com/pricing) للتسعير المنشور. تقوم واجهة برمجة تطبيقات الفاتورة المتوقعة حاليًا بتسعير عمليات السك والتحقق؛ وتحتاج المنتجات الأخرى إلى اتفاقية التسعير المطبقة عليها.

## بطاقات الأسعار

أسعار الاستخدام الفردي للسك والتحققات هي:

| العملية | المعدل |
| :- | :- |
| سك التصديق | 0.25 دولار لكل سك |
| التحقق | 0.10 دولار لكل عملية تحقق |

الأسعار مرئية في وحدة التحكم ضمن **الإعدادات > الفوترة > الاستخدام**.

> [!NOTE]
>
> تم تخفيض الأسعار بنسبة 50% في إصدار مارس 2026. كانت الأسعار السابقة 0.50 دولار لكل سك و 0.20 دولار لكل تحقق.

### بطاقات أسعار مخصصة للشركاء

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

تحدد كل بطاقة أسعار أسعار الوحدات للسك والتحقق، ويمكن تعيينها لمستأجر واحد أو أكثر بتاريخ سريان.

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

نطاقات الحجم متدرجة: إذا كانت أول 100 عملية تكلف 0.25 دولارًا لكل منها وتكلف العمليات اللاحقة 0.20 دولارًا، فإن 101 عملية تكلف 25.20 دولارًا. لا يعيد النطاق اللاحق تسعير العمليات السابقة. يجب أن تغطي النطاقات الكمية الكاملة دون فجوات أو تداخلات.

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

> [!NOTE]
>
> يتم الآن تسجيل الاستخدام المقبول في دفتر أستاذ غير قابل للتغيير ومفصول بيئيًا مع سعره، وبلده، ولقطة خطته. يتم تحديد الأسعار عند القبول بواسطة خدمة الفوترة، ولا يتم توفيرها بواسطة طابع زمني للتعبئة الخلفية للمتصل. لا تعيد التسعيرة الجديدة تسعير السجلات المقبولة. لا يتم فوترة العدادات المجمعة القديمة بأثر رجعي.
>
> تنتج الأشهر المغلقة بالتوقيت العالمي المنسق مسودات فواتير تلقائيًا. المسودة غير قابلة للدفع: يتطلب إصدارها مصادقة متعددة العوامل للموظفين، وعقد فاتورة نشط بنفس العملة، وبلد فوترة مُتحقق منه، وتأكيد موافقة العميل، ومراجعة ضريبية صريحة. لا تقوم سير العمل هذا بخصم طرق الدفع المحفوظة أو إرسال بريد إلكتروني. يتم تسجيل الأموال المستلمة والمتحقق منها بشكل منفصل، مع فحوصات المراجع المكررة والرصيد المستحق.
>
> تُستثنى الخطط المجانية، وخطط المستهلكين، وأنشطة Sandbox، والبرامج التجريبية المجانية المعتمدة من الاستخدام التجاري المقدر. يؤدي عدم وجود بيئة أو دليل تسعير للعمليات الأساسية إلى تعليق الشهر المتأثر للمراجعة. يدعم التسوية التلقائية حاليًا كتالوج الأسعار المقومة بالدولار الأمريكي، بما في ذلك خصوماته الإقليمية؛ وتُعلّق العملات الأخرى للمراجعة.

### توقعات الاستخدام

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

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

## حصص الاستحقاق

تحدد خطتك الحصص التالية:

| الحصة | المطور | المبتدئ | الأعمال | المؤسسي | المؤسساتي |
| :- | :- | :- | :- | :- | :- |
| سك التصديقات | 500/شهر | أعلى | مخصص | مخصص | مخصص |
| التحققات الشهرية | تعتمد على الخطة | تعتمد على الخطة | تعتمد على الخطة | تعتمد على الخطة | تعتمد على الخطة |
| المصدرون | 1 | متعدد | مخصص | مخصص | يعتمد على الخطة |
| المقاعد | 1 | متعددة | مخصص | مخصص | مخصص |
| مفاتيح التوقيع | 1 | متعددة | مخصص | مخصص | يعتمد على الخطة |
| نقاط نهاية Webhook | 1 | 3 | 10 | 25 | 25+ |
| التخزين | 1 جيجابايت | أعلى | مخصص | مخصص | مخصص |
| حد معدل API | 60 طلب/دقيقة | أعلى | مخصص | مخصص | مخصص |
| SSO و SCIM | — | — | متضمن | متضمن | متضمن |
| سجل الشفافية الخاص | — | — | — | متضمن | اختياري |
| تكامل HSM | — | — | — | متضمن | اختياري |
| اتفاقية مستوى الخدمة للدعم | المجتمع | بريد إلكتروني خلال 48 ساعة | 4 ساعات | ساعة واحدة | مخصص |

## الإضافات

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

| الإضافة | المفتاح | السعر الأساسي | ما يفتحه |
| :- | :- | :- | :- |
| مقاعد إضافية | `addon_seat` | 25 دولارًا/مقعد/شهر | +1 عضو فريق لكل وحدة تتجاوز حد خطتك. يدعم الكمية — حدد عدد المقاعد الإضافية التي تحتاجها عند الدفع. |
| اتفاقية مستوى الخدمة ذات الأولوية | `addon_sla_priority` | 199 دولارًا/شهر | الترقية إلى اتفاقية مستوى الخدمة بوقت استجابة 4 ساعات |
| السجل الخاص | `addon_private_log` | 499 دولارًا/شهر | مساحة اسم سجل الشفافية المخصصة |
| حزمة الامتثال | `addon_compliance` | 299 دولارًا شهريًا | تقارير امتثال SOC 2 وGDPR وHIPAA |
| العلامة البيضاء | `addon_whitelabel` | 199 دولارًا شهريًا | إزالة علامة Truthlocks التجارية من صفحات التحقق |
| تعزيز حد المعدل | `addon_ratelimit` | 149 دولارًا شهريًا | 10 أضعاف حدود معدل واجهة برمجة التطبيقات الافتراضية |
| الاحتفاظ الممتد | `addon_retention` | 99 دولارًا/شهر | الاحتفاظ بسجل التدقيق لمدة 10 سنوات (الافتراضي سنتان) |

إدارة الإضافات في وحدة التحكم من **الإعدادات > الفوترة > الإضافات**. يعرض سوق الإضافات جميع الإضافات المتاحة مع سعرها الإقليمي ووصفها وزر إرفاق بنقرة واحدة. تتيح لك الإضافات التي تدعم الكمية (مثل المقاعد الإضافية) اختيار عدد الوحدات قبل الشراء.

يمكنك أيضًا التحقق من إضافاتك النشطة واستحقاقاتك المحلولة عبر واجهة برمجة التطبيقات:

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/entitlements \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "plan_key": "plan_starter",
  "features": {
    "online_verification": true,
    "offline_bundles": true,
    "custom_metadata": true,
    "sso_scim": false
  },
  "quotas": {
    "attestations.mint": 5000,
    "seats": 4,
    "api_rate_limit": 1200,
    "storage_bytes": 10737418240,
    "webhook_endpoints": 3
  }
}
```

> [!NOTE]
>
> يتم تعديل تسعير الإضافات تلقائيًا بناءً على منطقتك ومزود الدفع الخاص بك. يتم تفعيل الإضافات المجانية (مثل المقاعد الإضافية في خطط المؤسسات) فورًا دون خطوة الدفع.

### تسعير الإضافات الإقليمية

يتم تعديل أسعار الإضافات تلقائيًا بناءً على بلد مؤسستك. يقوم نظام الفوترة بتجميع البلدان في مستويات تسعير ويطبق مضاعفًا على السعر الأساسي.

| المنطقة | المضاعف | البلدان |
| :- | :- | :- |
| المستوى 1 | 1.0x (سعر كامل) | الولايات المتحدة، المملكة المتحدة، ألمانيا، فرنسا، كندا، أستراليا، هولندا، سويسرا، اليابان، سنغافورة، أيرلندا، إيطاليا، إسبانيا، السويد، النرويج، الدنمارك، فنلندا، نيوزيلندا |
| أمريكا اللاتينية | 0.7x | البرازيل، المكسيك، الأرجنتين، كولومبيا، تشيلي، بيرو |
| الشرق الأوسط وشمال أفريقيا | 0.8x | الإمارات العربية المتحدة، المملكة العربية السعودية، مصر، إسرائيل، تركيا، جنوب أفريقيا |
| جنوب شرق آسيا | 0.6x | ID, TH, VN, PH, MY |
| أفريقيا | 0.5x | نيجيريا، كينيا، غانا، تنزانيا، أوغندا، رواندا |
| جنوب آسيا | 0.5x | IN, PK, BD, LK |

على سبيل المثال، تكلفة إضافة Compliance Pack بسعر أساسي 299 دولارًا شهريًا هي 149.50 دولارًا شهريًا لمستأجر في نيجيريا (مضاعف 0.5x).

تنطبق المضاعفات الإقليمية أيضًا على أسعار الاستخدام لكل عملية إنشاء وتحقق. يدفع المستأجر في الهند (0.5x) 0.125 دولار لكل عملية إنشاء و 0.05 دولار لكل عملية تحقق بدلاً من الأسعار القياسية 0.25 دولار و 0.10 دولار. يمكنك التحقق من أسعارك الفعلية باستخدام [نقطة نهاية الأسعار](https://docs.truthlocks.com/ar/api-reference/billing/rates.md).

> [!TIP]
>
> استخدم محدد البلد في صفحة الإضافات لمعاينة الأسعار لمنطقة معينة. لا يغير المحدد بلد الفوترة الخاص بك - بل يقوم فقط بتعديل الأسعار المعروضة.

## فواتير أمر الشراء

يمكن للمستأجرين من المؤسسات الدفع عبر أمر شراء كبديل لبطاقة الائتمان أو مزودي الدفع الإقليميين.

**1. تقديم أمر شراء**

انتقل إلى **الإعدادات > الفوترة** وحدد خيار أمر الشراء.
قم بتحميل مستند أمر الشراء (PDF)، وأدخل رقم أمر الشراء، والمبلغ، وتاريخ الانتهاء
التاريخ.

**2. المراجعة والتفعيل**

يقوم فريق فواتير Truthlocks بمراجعة أمر الشراء الخاص بك. بمجرد الموافقة عليه، سيتم
يتم تفعيله ويتم إصدار الفواتير مقابل رصيد أمر الشراء.

**3. تتبع حالة أمر الشراء**

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

> [!NOTE]
>
> يتوفر الفوترة بأمر الشراء في خطة Enterprise. اتصل بـ
> مدير الحساب إذا كنت بحاجة إلى دفع قائم على أمر الشراء (PO) على خطة مختلفة.

## تصدير المحاسبة

يمكن للمستأجرين من المؤسسات تصدير سجل فواتيرهم كملف CSV أو JSON لأغراض المحاسبة والمطابقة. تتضمن الصادرات رقم الفاتورة، والحالة، وتواريخ الإصدار والاستحقاق، والمبالغ، والضرائب، والعملة، ومراجع أوامر الشراء. إذا لم يتم توفير نطاق تاريخ، فإن التصدير يكون افتراضيًا لآخر 30 يومًا.

```bash theme={null}
curl "https://api.truthlocks.com/v1/billing/exports/accounting?format=csv&from=2026-01-01&to=2026-06-30" \
  -H "X-API-Key: tl_live_..."
```

| المعلمة | النوع | الوصف |
| :- | :- | :- |
| `format` | string | تنسيق التصدير: `csv` أو `json`. الافتراضي هو `csv`. |
| `from` | string | تاريخ البدء (`YYYY-MM-DD`، مثال: `2026-01-01`). الافتراضي هو 30 يومًا مضت. |
| `to` | string | تاريخ الانتهاء (`YYYY-MM-DD`، على سبيل المثال `2026-06-30`). الافتراضي هو اليوم. |

تقوم الاستجابة ببث الملف مباشرة. بالنسبة لعمليات تصدير CSV، يكون `Content-Type` هو `text/csv` مع رأس `Content-Disposition` للتنزيل.

يمكنك أيضًا تصدير الفواتير من وحدة التحكم في **الإعدادات > الفواتير > الفواتير > تصدير**.

> [!NOTE]
>
> تصدير المحاسبة متاح في خطة Enterprise. يتضمن التصدير جميع
> الفواتير ضمن النطاق الزمني المحدد، بما في ذلك الفواتير المدفوعة والمفتوحة والملغاة
> الفواتير.

## إخفاقات الدفع وفترات السماح

إذا فشلت عملية دفع، تتبع Truthlocks سير عمل وصول متدرج حتى يكون لديك وقت لحل المشكلة قبل فقدان الوصول. يمكنك التحقق من حالة الفوترة الحالية في أي وقت عبر نقطة النهاية [`GET /v1/billing/status`](https://docs.truthlocks.com/ar/api-reference/billing/status).

```bash theme={null}
curl https://api.truthlocks.com/v1/billing/status \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "status": "ACTIVE",
  "feature_mode": "NORMAL",
  "grace_until": null,
  "banner": null
}
```

تتقدم حالة الفواتير عبر ثلاث مراحل عند فشل الدفع:

| المرحلة | `feature_mode` | نافذة سماح افتراضية | ماذا يحدث |
| :- | :- | :- | :- |
| **متدهور** | `DEGRADED` | 7 أيام | فشل الدفع. تبدأ فترة سماح ويظهر شعار في وحدة التحكم. تظل جميع الميزات متاحة أثناء تحديث طريقة الدفع الخاصة بك. |
| **مقيد** | `RESTRICTED` | 14 يومًا | فترة السماح على وشك الانتهاء. عمليات الكتابة (السك، إنشاء المفتاح) معطلة. تستمر عمليات القراءة والتحقق في العمل. |
| **معلق** | `SUSPENDED` | — | انتهت فترة السماح. تم تعطيل جميع وصول API حتى يتم تسوية الدفع. |

يعرض الحقل `grace_until` الطابع الزمني ISO 8601 عند انتهاء فترة السماح الحالية. قم بتسوية الدفع قبل هذا التاريخ لاستعادة الوصول الكامل تلقائيًا. تنطبق نوافذ السماح أعلاه على وضع العقد القياسي - تستخدم أوضاع المؤسسات والحكومات نوافذ أطول. راجع [أوضاع العقد](#contract-modes) للحصول على التفاصيل.

### أوضاع العقد

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

| الوضع | إعادة المحاولات | فترة السماح | متى تستخدم |
| :- | :- | :- | :- |
| **قياسي (تلقائي)** | محاولات إعادة تلقائية عند T+24h، T+48h، T+72h | 7 أيام (متدهور) ثم 14 يومًا (مقيد) قبل التعليق | المستأجرون الذين يدفعون ذاتيًا عن طريق بطاقة الائتمان أو مزود الدفع الإقليمي |
| **المؤسسة (يدوي)** | لا توجد محاولات تلقائية — يتدخل مسؤول الفواتير | 21 يومًا (متدهور) ثم 28 يومًا (مقيد) — نوافذ قياسية بالإضافة إلى 14 يومًا إضافيًا | حسابات المؤسسات التي تدفع عن طريق التحويل البنكي أو أمر الشراء |
| **الحكومة (لا توجد إعادة محاولة)** | لا توجد محاولات تلقائية | فترة سماح ثابتة مدتها 90 يومًا؛ لا يوجد تعليق تلقائي | سير عمل المشتريات الحكومية حيث تكون الجداول الزمنية للدفع خارج سيطرتك |

يرسل الوضع القياسي ما يصل إلى ثلاث تذكيرات بالدفع على فترات 24 ساعة و 48 ساعة و 72 ساعة بعد كل انتقال للمرحلة. تتخطى أوضاع المؤسسات والحكومات عمليات إعادة المحاولة التلقائية تمامًا - يجب على مسؤول الفواتير حل الدفع يدويًا.

> [!NOTE]
>
> يتم تسجيل تغييرات وضع العقد في سجل التدقيق وتتطلب سببًا. اتصل بالدعم لطلب تغيير وضع العقد.

عند استخدام [نقطة نهاية التقدير](https://docs.truthlocks.com/ar/api-reference/billing/estimate.md)، يمكنك تمرير `contract_mode` كـ `ENTERPRISE_CONTRACT` أو `GOVERNMENT_PROCUREMENT` للحصول على توصية خطة تأخذ في الاعتبار نوع العقد. يؤدي حذف هذا الحقل إلى تعيين القيمة الافتراضية إلى `STANDARD_SELF_SERVE`.

> [!TIP]
>
> تحقق من `feature_mode` في تكاملك لعرض مطالبات الترقية أو الدفع
> لمستخدميك قبل تقييد الوصول. يتم تضمين رسالة `banner` عندما
> الإجراء مطلوب. راجع [مرجع واجهة برمجة تطبيقات حالة الفواتير](https://docs.truthlocks.com/ar/api-reference/billing/status.md) للحصول على تفاصيل الاستجابة الكاملة وأمثلة الاستخدام.

## إدارة الفواتير

تتم إدارة جميع إعدادات الفواتير في وحدة التحكم ضمن **الإعدادات > الفواتير**. من هناك يمكنك:

* عرض خطتك الحالية واستحقاقاتك
* مراقبة عدادات الاستخدام واستهلاك المعدل
* ترقية خطتك أو تخفيضها
* عرض وتنزيل الفواتير
* تصدير الفواتير للمحاسبة (Enterprise)
* إرسال أوامر الشراء (لحسابات المؤسسات)
* إرفاق أو فصل الإضافات

## التحقق من الحدود عبر واجهة برمجة التطبيقات

قبل إجراء عملية قابلة للفوترة، يمكنك التحقق مما إذا كانت حصتك الحالية تسمح بذلك:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/billing/limits/check \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"metric": "attestations.mint", "amount": 1}'
```

يشير الرد إلى ما إذا كانت العملية مسموح بها بموجب خطتك الحالية:

```json theme={null}
{
  "allowed": true,
  "used": 158,
  "limit": 500,
  "delta": 1
}
```

### تمديدات فترة السماح في فحوصات الحدود

إذا تجاوز استخدامك حد خطتك ولكن مسؤول النظام الأساسي قد منح فترة سماح لهذا المقياس، فإن الاستجابة تتضمن كائن `grace` مع تفاصيل السماح المؤقت:

```json theme={null}
{
  "allowed": true,
  "used": 510,
  "limit": 500,
  "grace": {
    "active": true,
    "amount": 100,
    "expires_at": "2026-04-15T12:00:00Z"
  },
  "delta": 1
}
```

## ذات صلة

> [card] [إدارة الاشتراك](https://docs.truthlocks.com/guides/subscription-management.md)
>
> اشترك، وقم بالترقية، وأرفق الإضافات، وألغِ عبر API.

> [card] [توجيه المزود](https://docs.truthlocks.com/billing/provider-routing.md)
>
> كيف يتم توجيه المدفوعات حسب المنطقة.

> [card] [قائمة الخطط](https://docs.truthlocks.com/api-reference/billing/plans.md)
>
> جلب مستويات الخطط المتاحة مع الأسعار والميزات.

> [card] [الحصول على الأسعار](https://docs.truthlocks.com/api-reference/billing/rates.md)
>
> أسعارك الفعلية لكل استخدام مع التعديلات الإقليمية.

> [card] [تقدير التكاليف](https://docs.truthlocks.com/api-reference/billing/estimate.md)
>
> احصل على توصية بخطة بناءً على الاستخدام المتوقع.

> [card] [واجهة برمجة تطبيقات حالة الفواتير](https://docs.truthlocks.com/api-reference/billing/status.md)
>
> تحقق من حالة الفوترة لديك، ووضع الميزة، وحالة فترة السماح.

> [card] [مرجع واجهة برمجة تطبيقات الفواتير](https://docs.truthlocks.com/api-reference/billing/config.md)
>
> نقاط نهاية التكوين، والاستحقاقات، والدفع، والاشتراك، والفاتورة.

> [card] [واجهة برمجة تطبيقات الاستخدام](https://docs.truthlocks.com/api-reference/billing/usage.md)
>
> تحقق من عدادات استخدام دورة الفوترة الحالية.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.