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

المتطلبات الأساسية

  • حساب Truthlocks مع مستأجر نشط.
  • مفتاح API مع أذونات الفوترة. راجع مفاتيح API لإنشاء واحد.

اختر خطة

تقدم Truthlocks خمس مستويات من الخطط. استخدم نقطة نهاية الخطط لجلب الكتالوج الكامل — هذه نقطة نهاية عامة ولا تتطلب مصادقة.
راجع نظرة عامة على الفواتير لمقارنة جميع الخطط.

تقدير التكاليف الخاصة بك

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

تحقق من أسعارك الحالية

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

الاشتراك في خطة

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

إنشاء جلسة دفع

استدعِ نقطة نهاية الدفع بالخطة التي تريدها وعناوين URL لإعادة التوجيه:
يحتوي الرد على checkout_url مستضاف من قبل مزود الدفع.
2

إعادة التوجيه إلى صفحة الدفع

أرسل المستخدم إلى checkout_url لإكمال الدفع.
3

تأكيد الاشتراك

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

إرفاق إضافات

توسع الإضافات خطتك بقدرات إضافية. قم بإرفاقها عبر API:
إذا كان للإضافة سعر، تتضمن الاستجابة checkout_url لإتمام الدفع. يتم تفعيل الإضافات المجانية على الفور.
تتعدل أسعار الإضافات تلقائيًا بناءً على بلد الفوترة لمؤسستك. يدفع المستأجرون في المناطق ذات التكلفة المنخفضة سعرًا مخفضًا — على سبيل المثال، تبلغ تكلفة حزمة الامتثال 149.50 دولارًا أمريكيًا/شهريًا في نيجيريا (مضاعف 0.5x) بدلاً من السعر الأساسي البالغ 299 دولارًا أمريكيًا. راجع تسعير الإضافات الإقليمية لجدول المستويات الكامل.
لإزالة إضافة:
راجع إدارة الإضافات للحصول على كتالوج الإضافات الكامل وتفاصيل الاستجابة.

مراقبة الاستخدام

تتبع استهلاك دورة الفوترة الحالية للبقاء ضمن حدود خطتك:
للتحقق مما إذا كانت عملية معينة ضمن الحصة قبل تنفيذها:

فتح بوابة الفواتير

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

إلغاء الاشتراك

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

ذات صلة

نظرة عامة على الفواتير

خطط للمستويات، والأسعار، والاستحقاقات، والإضافات.

توجيه المزود

كيف يتم توجيه المدفوعات حسب المنطقة.

مرجع واجهة برمجة تطبيقات الفواتير

مرجع كامل لنقطة نهاية API الخاصة بالفوترة.

الاستحقاقات

تحقق من ميزاتك وحصصك النشطة.