في الآخر طلب مدفوع على منصتك بيعمل خط وكل دفعة بتجدّده، من غير لوحة التحكم. محتاج حساب شريك (موزّع) بكريدت وحزم يقدر يبيعها، ومنصة ليها موصّل — 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 Key. المفتاح بيظهر مرة واحدة لما بيتعمل — انسخه على طول. اعمل مفتاح إضافي لكل نظام، باسم والعناوين المسموح لها تستخدمه، عشان تقدر تلغي واحد من غير ما تلمس الباقي؛ والموصّل محتاج مفتاح يقدر يكتب، فسيب علامة القراءة فقط مقفولة.
اختار الموصّل
افتح Resources ← All Connectors واختار منصتك. صفحته بتسرد تفاصيل الاتصال وخطوات التثبيت وزر Download وقيمة SHA-256 للملف عشان تتحقق منه، ومدى اختبار الموصّل ده — بعضها اشتغل جوه المنصة الفعلية وبعضها اتختبر جوهره بس. المصدر مفتوح؛ ونفس الملفات منشورة على موقع الموصّلات.
ثبّته على منصتك
اتحقق من المجموع الاختباري وثبّت الملف حيث صفحة الموصّل بتقول: مجلد الوحدات في WHMCS أو Blesta أو FOSSBilling، ورفع الإضافة في WordPress، ومجلد addons في Odoo، ومثبّت الامتدادات في OpenCart، وهكذا. وجسر webhook لـ Shopify وUpmind وInvoice Ninja تطبيق PHP صغير بتستضيفه بنفسك. الموصّل مش بيعمل غير إنه بينادي Reseller API بمفتاحك: يقدر يعمل اللي حسابك يقدر يعمله، مش أكتر.
اظبطه
في إعدادات الموصّل ادخل عنوان سيرفر API (مساره /reseller/v1) والمفتاح، وبعدين اربط كل منتج في منصتك بحزمة مجموعتك تقدر تبيعها. الأسعار والدفع بيفضلوا على منصتك: اللوحة مش بتاخد فلوس وملهاش بوابة دفع.
اعمل طلب تجريبي
اطلب المنتج في بيئة اختبار لمنصتك. الموصّل بينادي create_line مع الحزمة ومعرّف الطلب؛ فالخط بيظهر في Lines بمدة الحزمة كتاريخ انتهاء، ومنصتك بتستلم بيانات دخوله. والتجديد بينادي renew_line بمعرّف طلب خاص بيه، فإعادة المحاولة بعد خطأ شبكة عمرها ما بتتحاسب مرتين. وصفحة API Key بتسرد النداءات الأخيرة مع الإجراء والنتيجة ورمز الخطأ والعنوان واسم الموصّل.
ضيف webhooks (اختياري)
في صفحة API Key ضيف نقطة webhook (عنوان https لمنصتك) للأحداث اللي عايزها: line.created وline.renewed وline.enabled وline.disabled وline.deleted وline.expiring وline.expired وcredits.low. كل إشعار بيتوقّع بالسر اللي بيظهر مرة واحدة عند الإنشاء (X-Xtream-Signature) وعمره ما بيشيل كلمة سر؛ وزر Test بيبعت واحد على طول.