الفوترة والأرصدة

إصدار API 2026-10-virile-dragon

طريقتان للدفع

يُفوتَر العميل بإحدى طريقتين، ويُثبَّت وضعه عند إنشائه. يستهلك عميل allowance الحصة المضمّنة في خطة مالكه، وهي الحصة نفسها التي تستهلكها تطبيقاتك، ولا يُحمِّل أي بطاقة شيئًا أبدًا. أما عميل metered فلا يستهلك أي حصة: بل يكلّف كل استدعاء من استدعاءاته أرصدةً تُحمَّل على البطاقة المرتبطة باشتراك الفوترة بحسب الاستهلاك. والاستدعاء الذي يجريه تطبيق نيابةً عن مستخدم آخر، برمز وصول مأخوذ من رمز تفويض، يستهلك دائمًا حصة ذلك المستخدم، أيًّا كان وضع العميل.

الأرصدة لكل استدعاء

يكلّف استدعاء عميل metered عدد الأرصدة التي يساويها نطاقه، كما يسردها الجدول أدناه؛ والنطاق الذي يساوي 0 أرصدة لا يكلّف شيئًا. تتحوّل units التي يعرضها GET /v1/usage إلى أرصدة بهذه الأوزان. ويُفوتَر الاستدعاء بالأوزان السارية في يوم إجرائه، أيًّا كان الإصدار المثبَّت عليه العميل: فالجدول في مرجع إصدار أقدم يسجّل الأوزان كما كانت عند نشر ذلك الإصدار، لا ما يكلّفه الاستدعاء اليوم.

السعر

يكلّف الرصيد الواحد 0.004 دولار أمريكي. يُفوتَر الاستخدام شهريًا، عن كل شهر ميلادي يبدأ في اليوم الأول منه (بتوقيت UTC)، على البطاقة المرتبطة باشتراك الفوترة بحسب الاستهلاك.

حدود الإنفاق

لحسابك حدّ شهري بالأرصدة، ويمكن أن يكون لكل عميل metered حدّ خاص به أدنى منه؛ اضبط كليهما في صفحة عمليات التكامل. وعندما يبلغ العميل أو حسابك حدّه، تُرفض استدعاءات العميل بالحالة 402 والرمز spend_cap_reached حتى يبدأ الشهر التالي أو يُرفع الحدّ.

حين تكون الفوترة بحسب الاستهلاك غير مفعّلة

تُرفض استدعاءات عميل metered بالحالة 402 والرمز metered_billing_inactive ما دامت الفوترة بحسب الاستهلاك غير مفعّلة: قبل إعدادها، وأثناء تأخّر دفعة عن موعدها، وبعد إلغائها. أعِدّ الفوترة بحسب الاستهلاك أو أدِرها أو ألغِها في صفحة عمليات التكامل، على app.getlingara.com/admin. وتفتح إدارتها بوابة الفوترة في Stripe، حيث يمكنك تغيير بطاقتك وقراءة فواتيرك.

إذا اختلفت ترجمةٌ عن المرجع الإنجليزي، فالمرجع الإنجليزي هو الصحيح.