في النهاية ينشئ طلب مدفوع على منصتك خطًا وتجدّده كل دفعة، دون لوحة التحكم. تحتاج إلى حساب شريك (موزّع) برصيد وحزم يجوز له بيعها، ومنصة لها موصّل — WHMCS أو Blesta أو WISECP أو HostBill أو ClientExec أو FOSSBilling أو Paymenter أو WordPress مع WooCommerce أو Easy Digital Downloads أو Odoo أو PrestaShop أو OpenCart أو Magento أو Dolibarr أو ERPNext، أو Shopify وUpmind وInvoice Ninja عبر جسر webhook.
إنشاء مفتاح API
سجّل الدخول بحساب الشريك وافتح مفتاح API. يظهر المفتاح مرة واحدة عند إنشائه — انسخه فورًا. أنشئ مفتاحًا إضافيًا لكل نظام، باسم والعناوين المسموح لها باستخدامه، ليمكن إلغاء أحدها دون المساس بالبقية؛ والموصّل يحتاج إلى مفتاح يستطيع الكتابة، فاترك علامة القراءة فقط معطّلة.
اختيار الموصّل
افتح الموارد ← كل الموصّلات واختر منصتك. تسرد صفحته تفاصيل الاتصال وخطوات التثبيت وزر تنزيل وقيمة SHA-256 للملف للتحقق منه، ومدى اختبار ذلك الموصّل — بعضها عمل داخل المنصة الفعلية وبعضها اختُبر جوهره فقط. المصدر مفتوح؛ والملفات نفسها منشورة على موقع الموصّلات.
تثبيته على منصتك
تحقق من المجموع الاختباري وثبّت الملف حيث تقول صفحة الموصّل: مجلد الوحدات في WHMCS أو Blesta أو FOSSBilling، ورفع الإضافة في WordPress، ومجلد addons في Odoo، ومثبّت الامتدادات في OpenCart، وهكذا. وجسر webhook لـ Shopify وUpmind وInvoice Ninja تطبيق PHP صغير تستضيفه بنفسك. لا يفعل الموصّل سوى استدعاء Reseller API بمفتاحك: يستطيع فعل ما يستطيعه حسابك، لا أكثر.
إعداده
في إعدادات الموصّل أدخل عنوان خادم API (مساره /reseller/v1) والمفتاح، ثم اربط كل منتج في منصتك بحزمة يجوز لمجموعتك بيعها. تبقى الأسعار والدفع على منصتك: فاللوحة لا تأخذ مالًا وليس لها بوابة دفع.
إجراء طلب تجريبي
اطلب المنتج في بيئة اختبار لمنصتك. يستدعي الموصّل create_line مع الحزمة ومعرّف الطلب؛ فيظهر الخط في الخطوط بمدة الحزمة كتاريخ انتهاء، وتتلقى منصتك بيانات دخوله. ويستدعي التجديد renew_line بمعرّف طلب خاص به، فلا تُحاسَب إعادة المحاولة بعد خطأ شبكة مرتين. وتسرد صفحة مفتاح API الاستدعاءات الأخيرة مع الإجراء والنتيجة ورمز الخطأ والعنوان واسم الموصّل.
إضافة webhooks (اختياري)
في صفحة مفتاح API أضف نقطة webhook (عنوان https لمنصتك) للأحداث التي تريدها: line.created وline.renewed وline.enabled وline.disabled وline.deleted وline.expiring وline.expired وcredits.low. يُوقَّع كل إشعار بالسر الذي يظهر مرة واحدة عند الإنشاء (X-Xtream-Signature) ولا يحمل كلمة مرور أبدًا؛ ويرسل زر الاختبار إشعارًا فورًا.