نظام وكلاء سمارت ون: أسعار خاصة وAPI لبيع الدومينات والاستضافة من موقعك
الخلاصة: نظام الوكلاء في سمارت ون يتيح لحسابات مجموعة «الموزعين (شراكات)» بيع الدومينات والاستضافة من موقع الوكيل أو تطبيقه أو WHMCS. الوكيل يحدد سعر البيع لزبونه، وسمارت ون تخصم سعر الجملة من محفظة الوكيل وتنفّذ الخدمة. في 24 أكتوبر 2026 خصم مجموعة الموزعين 25% على تصنيف الاستضافة المشتركة و10% على خدمة تسجيل وتجديد الدومينات، ويمكن تثبيت سعر خاص لوكيل أو لامتداد أو لدورة فوترة. مبلغ فتح الـ API رصيد شراء، وحاليًا 2000 جنيه مصري، وليس رسوم تفعيل.
هذا الدليل يشرح نظام الوكلاء وواجهة Reseller API كما تعمل داخل المنصة: من يرى القسم، كيف تُحسب أسعار الجملة، ماذا يستطيع الوكيل بيعه من موقعه، ومتى يُنفَّذ الطلب ومتى يتوقف حتى الدفع. الأرقام المذكورة هنا هي إعدادات البرنامج في تاريخ النشر. المبلغ الذي يرجع مع إنشاء الطلب هو المبلغ الذي يُخصم، وهو المرجع إذا تغيّر خصم أو سعر بعد ذلك.
ما هو نظام الوكلاء؟
الوكيل حساب عميل لدى سمارت ون يبيع خدماتها باسمه. زبون الوكيل يطلب الدومين أو الاستضافة من موقع الوكيل أو من لوحة WHMCS الخاصة به. نظام الوكيل يرسل الطلب إلى واجهة سمارت ون، والمنصة تسجّل الدومين أو تنشئ حساب الاستضافة وتخصم التكلفة من محفظة الوكيل.
الخدمة تُنشأ على حساب الوكيل نفسه. سمارت ون لا تفتح حساب بوابة لكل زبون نهائي. الوكيل يملك علاقة البيع والسعر والدعم الأمامي، ويدير الدومين أو الاستضافة من الـ API ليسلّمها لزبونه. مفاتيح المسجّل ولوحة الخادم لا تُسلَّم للوكيل، والتسعير والتنفيذ يبقيان داخل المنصة.
البرنامج ظاهر اليوم لمجموعة العملاء الموزعين (شراكات). الحساب خارج هذه المجموعة لا يرى قسم «API وإعادة البيع» ولا تعمل مفاتيحه. للانضمام إلى المجموعة راسل سمارت ون أو راجع صفحة الشراكات.
كيف يُفعَّل الـ API؟
بعد وضع الحساب في مجموعة الموزعين يظهر القسم في بوابة العميل على صفحة API وإعادة البيع. التفعيل من الحساب مباشرة، بدون طلب موافقة إضافي، إذا تحققت ثلاثة شروط:
- الموديول يعمل من لوحة الإدارة.
- الحساب داخل مجموعة الموزعين.
- رصيد المحفظة يبلغ حد الفتح على الأقل.
حد الفتح الحالي 2000 جنيه مصري. هذا المبلغ يبقى رصيدًا قابلًا للشراء، ولا يُخصم كرسوم اشتراك في البرنامج. إذا كان الرصيد أقل، الصفحة تحيل إلى شحن المحفظة. عند التفعيل يختار الوكيل الربط عبر API، أو WHMCS، أو الاثنين معًا.
إذا أوقفت الإدارة الموديول، أو أوقفت حساب وكيل بعينه، تتوقف الطلبات الجديدة. الخدمات التي نُفِّذت قبل الإيقاف تبقى تعمل.
ما أسعار الوكلاء الخاصة؟
سعر صفحة التسعير العامة هو سعر الزائر. الوكيل لا يشتري به. سعره يُبنى من ثلاث طبقات، والحساب يتم على الخادم لا على الرقم الذي يعرضه موقع الوكيل:
- خصم مجموعة الموزعين. في 24 أكتوبر 2026 الخصم 25% على تصنيف الاستضافة المشتركة، و10% على خدمة تسجيل وتجديد الدومينات. خدمة خارج هذا التصنيف لا تأخذ نسبة الاستضافة تلقائيًا.
- نسبة خصم خاصة بالوكيل. الإدارة تستطيع إضافة نسبة على حساب الوكيل داخل الـ API. تُطبَّق عندما لا يوجد سعر ثابت مطابق.
- سعر ثابت (سعر خاص). سعر بالجنيه لتركيبة من الخدمة، أو امتداد الدومين، أو العملية (تسجيل، تجديد، نقل، استضافة)، أو دورة الفوترة. إذا طابق السعر الثابت الطلب، يُعتمد كما هو ولا تُضاف إليه نسبة الخصم. القاعدة الأخص تطابقًا هي التي تفوز.
مثال: وكيل يبيع استضافة مشتركة على موقعه بـ 150 جنيهًا في الشهر. سمارت ون تخصم من محفظته سعر الجملة بعد خصم الشراكة، أو السعر الثابت إن وُجد له. الفرق بين سعر زبونه وسعر الجملة هامشه، ويحدده هو على موقعه. الـ API لا يفرض سعر البيع للزبون النهائي.
صلاحية عرض السعر على الطلب غير المدفوع 72 ساعة في الإعداد الحالي. إذا انتهت وتغيّر الكتالوج، يتوقف التنفيذ حتى تحديث السعر أو قبوله من الـ API، حتى لا يُنفَّذ طلب بسعر قديم. اقرأ تكلفة الجملة من رد إنشاء الطلب قبل أن تؤكد البيع لزبونك، ولا تحفظ جدول أسعار في موقعك إلى الأبد.
قائمة GET /api/v1/reseller/pricing وGET /api/v1/reseller/domains/tlds وGET /api/v1/reseller/hosting/plans تُرجع أسعار هذا المفتاح بعد خصم الوكيل أو سعره الثابت. مبلغ الفاتورة النهائي هو ما يرجع مع الطلب، لأنه يشمل خصم المجموعة أيضًا.
كيف تبيع الخدمة من موقعك؟
موقعك أو تطبيقك هو واجهة الزبون. سمارت ون هي جهة التنفيذ والمحفظة. المسار المعتاد:
- الزبون يبحث عن دومين أو يختار خطة استضافة على موقعك، بالسعر الذي وضعته أنت.
- موقعك يستدعي الـ API بمفتاح حسابك.
- إذا غطى رصيد محفظتك سعر الجملة، يرجع الطلب 201 ويدخل قائمة التنفيذ.
- إذا لم يكفِ الرصيد، يرجع الطلب 202 مع فاتورة ورابط دفع على حسابك. لا يُسجَّل دومين ولا تُنشأ استضافة قبل دفع هذه الفاتورة.
- بعد الدفع من المحفظة، أو بعد سداد الفاتورة، تتابع حالة الطلب حتى الاكتمال. زبونك يدفع لك، وأنت تدفع لسمارت ون.
عنوان الواجهة: https://sog.sog.eg/api/v1/reseller. التوثيق الآلي متاح على OpenAPI. كل طلب يحمل Authorization: Bearer ومفتاح الحساب. أي عملية تنشئ طلبًا أو تدفع فاتورة ترسل معها الترويسة Idempotency-Key، من 8 إلى 80 حرفًا من حروف وأرقام و_ . : -. إعادة نفس المفتاح مع نفس الجسم تُرجع النتيجة الأولى ولا تنشئ طلبًا ثانيًا. نفس المفتاح مع جسم مختلف يُرفض.
فحص الدومين ثم تسجيله يمر هكذا، مع أرقام خدمات ومفاتيح حقيقية تُستبدل من حسابك:
POST /api/v1/reseller/domains/check
{"domain":"example.com"}
POST /api/v1/reseller/domains/register
Idempotency-Key: reg-example-com-1
{"service_id":12,"domain":"example.com","years":1}طلب الاستضافة يحدد رقم الخطة والدومين ودورة الفوترة، مثل monthly. رقم الخطة يأتي من قائمة خطط الاستضافة، لا من سعر تكتبه في الطلب. أي سعر يرسله موقعك يُهمل، والمنصة تعيد الحساب.
ماذا تستطيع أن تبيعه وتديره؟
المفتاح يعمل داخل صلاحيات حسابك. الإدارة تستطيع قصر الحساب على الدومينات فقط، أو الاستضافة فقط، أو الاثنين. الصلاحيات الافتراضية عند الفتح تغطي القراءة والبيع والإدارة والفوترة والويب هوك. إيقاف حساب الاستضافة نهائيًا صلاحية إضافية لا تُمنح تلقائيًا.
| المجال | ما يفعله الوكيل من موقعه |
|---|---|
| الدومينات | فحص التوفر، التسجيل، النقل، التجديد، وسرد الدومينات التابعة لحسابه |
| إدارة الدومين | النيم سيرفر، وسجلات DNS، وبيانات الاتصال، ورمز النقل، وحالة الدومين |
| الاستضافة | إنشاء حساب على خطة، وسرد الحسابات، والاستهلاك، وتغيير الخطة أو كلمة المرور |
| حالة الاستضافة | إيقاف مؤقت وإعادة تشغيل. الحذف النهائي يحتاج صلاحية مستقلة |
| الحساب | الرصيد، والفواتير، ودفع فاتورة من المحفظة، وسجل الطلبات |
حالات الطلب التي يرجعها الـ API: بانتظار الدفع، مدفوع، في قائمة التنفيذ، قيد التنفيذ، مكتمل، بانتظار المزوّد، فشل، ملغى، استرداد قيد التنفيذ، ومسترد. إذا دُفع تسجيل دومين ثم لم يعد الاسم متاحًا، يُسترد المبلغ ولا يُسلَّم دومين بديل بصمت.
لمعرفة ما تحتاجه مستندات النطاقات المصرية نفسها، راجع دليل تسجيل دومين .com.eg و.eg وملكية دومين الشركة قبل نقله. واجهة الوكيل تنفّذ الطلب، ولا تلغي شروط المسجّل ولا مستندات الامتداد.
مفتاح تجريبي ومفتاح تشغيل
من صفحة المفاتيح في البوابة يُنشأ نوعان. المفتاح يُعرض مرة واحدة، ويُحفظ عنده لا في تذكرة دعم ولا في مستودع عام.
- مفتاح الاختبار يبدأ بـ
sog_test_. يكمل الطلب داخل المنصة فقط. لا يسجّل دومينًا حقيقيًا ولا ينشئ حساب استضافة حقيقيًا على الخادم. - مفتاح التشغيل يبدأ بـ
sog_live_. يخصم من المحفظة وينفّذ الخدمة الفعلية.
الحد الافتراضي 60 طلبًا في الدقيقة لكل حساب، ويمكن للإدارة تغييره أو حصر المفتاح بعناوين IP. لا تسجّل في سجلات موقعك مفتاح الـ API، ولا سر الويب هوك، ولا رمز نقل الدومين، ولا كلمة مرور الاستضافة.
الويب هوك: موقعك يعرف أن الخدمة اكتملت
بدل الانتظار والسؤال المتكرر فقط، يستطيع موقعك استقبال إشعار HTTPS عند تغيّر الطلب. من الأحداث: إنشاء الطلب، وإنشاء الفاتورة، ودفعها، وبقاء الطلب بانتظار الدفع، وبدء التنفيذ، واكتماله، وفشله، وتسجيل الدومين، وتفعيل الاستضافة.
الإشعار طلب POST موقّع بـ HMAC-SHA256 على النص {timestamp}.{raw_body} باستخدام سر يُعرض مرة واحدة عند إنشاء الرابط. الترويسات: X-Reseller-Signature وX-Reseller-Timestamp وX-Reseller-Delivery. عامل معرف التسليم كمفتاح عدم تكرار، لأن التسليم قد يُعاد. التحقق من التوقيع يتم على الجسم الخام قبل تفسير JSON.
البيع من WHMCS
إذا كانت واجهة البيع عندك WHMCS لا موقعًا مبرمجًا من الصفر، البوابة تعطي أرشيفًا يُفك داخل جذر WHMCS ويضع ثلاث وحدات: مسجّل دومينات، وموديول استضافة، وإضافة مزامنة. بعد التفعيل من البوابة:
- فعّل إضافة SmartOne Sync، واجعل عنوان الـ API هو
https://sog.sog.eg/api/v1/reseller. - الصق مفتاح التشغيل، أو أدخل بريد البوابة وكلمة المرور مرة واحدة. كلمة المرور لا تُخزَّن. الربط يطلب مفتاحًا باسم WHMCS ويحفظ المفتاح فقط.
- احفظ رقم خدمة الدومينات الذي يظهر بعد الاتصال، واربط كل منتج استضافة برقم خطته.
- سيرفر الاستضافة نوعه SmartOne Hosting. اسم المستضيف هو عنوان الـ API، وAccess Hash هو المفتاح.
- نجاح اختبار الاتصال يعني أن المفتاح صحيح. لا يعني أن الرصيد يغطي الطلب. إذا نقص الرصيد تبقى الخدمة معلقة في WHMCS حتى دفع فاتورة الوكيل، ثم تُعاد العملية. نفس المحاولة لا تنشئ طلبًا ثانيًا.
لا تُبلغ WHMCS بالنجاح قبل أن تصبح حالة الطلب completed. في صفحة التوثيق داخل البوابة يوجد نص جاهز تنسخه إلى وكيل ذكاء اصطناعي ليركّب هذا الربط على نسختك، من غير أن يتصل بالمسجّل أو بلوحة الخادم مباشرة ومن غير أن يخترع أسعارًا.
أسئلة شائعة عن نظام الوكلاء
هل أقدر أبيع دومينات واستضافة سمارت ون من موقعي؟
نعم، إذا كان حسابك في مجموعة الموزعين وفعّلت الـ API. موقعك يعرض سعرك، والـ API ينفّذ بسعر الجملة ويخصمه من محفظتك.
هل أسعار الوكلاء مختلفة عن سعر الموقع؟
نعم. مجموعة الموزعين لها خصم شراكة، وفي تاريخ هذا الدليل هو 25% على الاستضافة المشتركة و10% على خدمة تسجيل وتجديد الدومينات. وفوق ذلك يمكن تثبيت نسبة أو سعر خاص لوكيل معيّن أو لامتداد معيّن.
هل مبلغ 2000 جنيه رسوم اشتراك؟
لا. هو الحد الأدنى لرصيد المحفظة عند فتح الـ API، ويبقى قابلًا لشراء الدومينات والاستضافة. الإدارة تستطيع تغيير الحد لاحقًا، والقيمة الظاهرة في بوابتك هي المعتمدة.
ماذا لو كان رصيد المحفظة أقل من سعر الطلب؟
الطلب يُنشأ بحالة بانتظار الدفع، مع فاتورة ورابط دفع. لا يُنفَّذ شيء حتى تُدفع الفاتورة. بعد الشحن يمكن دفعها من المحفظة بنداء مستقل ومفتاح عدم تكرار جديد.
هل مفتاح الاختبار يحجز دومينًا حقيقيًا؟
لا. مفتاح sog_test_ يحاكي الاكتمال داخل المنصة ولا يسجّل دومينًا ولا يفتح حساب استضافة على الخادم.
هل أستلم بيانات الدخول إلى المسجّل أو الخادم؟
لا. التنفيذ يتم عند سمارت ون. أنت تدير خدمات حسابك عبر الـ API: دومينات، DNS، واستضافة، ضمن صلاحيات مفتاحك.
هل الخصم يظهر لزبون الوكيل؟
لا. الزبون يرى السعر الذي تضعه على موقعك أو في WHMCS. خصم الشراكة والسعر الخاص يحسبان ما تدفعه أنت لسمارت ون.
ابدأ من حسابك
إذا كان حسابك ضمن الموزعين، اشحن المحفظة إلى حد الفتح ثم فعّل الربط من بوابة API وإعادة البيع. ابدأ بمفتاح اختبار، وصِل موقعك أو WHMCS، واقرأ سعر الجملة من رد الطلب قبل أول عملية حقيقية. إذا لم يظهر القسم في حسابك، اطلب إضافة الحساب إلى مجموعة الموزعين عبر صفحة التواصل.
