قبول المدفوعات عبر lava.top
دليل خطوة بخطوة: كيف تربط حساب lava.top الخاص بك مع CreateYourVPN لتتحوّل دفعة العميل تلقائياً إلى اشتراك — مفتاح API، وويب هوك واحد، وربط العروض بخططك.
lava.top مزوّد دفع يقبل البطاقات وSBP وPayPal بالروبل والدولار واليورو. تربطه مرة واحدة — فتتحوّل الدفعة في واجهتك تلقائياً إلى اشتراك فعّال: لا حاجة لمنح الوصول يدوياً.
تذهب الأموال إلى حسابك أنت في lava.top. CreateYourVPN ليست وسيطاً في المدفوعات ولا تأخذ عمولة من مبيعاتك.
قبول المدفوعات جزء من خطة Max المدفوعة — وهي التي تنقل الواجهة إلى وضع البيع. عن أسعار المنصّة انظر درس الفوترة.
ما ستحتاج إليه
- حساب على lava.top (حساب مؤلّف — الحساب الذي يبيع)؛
- 10–15 دقيقة للإعداد الأولي؛
- مبلغ صغير لدفعة اختبارية: لا توجد لدى lava.top بيئة اختبار، والطريقة الوحيدة للتحقّق من الإعداد كاملاً هي عملية شراء حقيقية (الحد الأدنى 50 ₽ / 5 $ / 5 €).
الخطوة 1. التسجيل والتحقّق
سجّل في lava.top واملأ ملفك الشخصي — فمع ملف فارغ تبدو صفحة الدفع للمشتري غير مكتملة.
ثم ادخل إلى Balance ← التحقّق: وثيقة وصورة ذاتية، 18+، دون تشغيل VPN.
البيع ممكن حتى قبل التحقّق، أما سحب الأموال فلا يتم بدونه. لا تؤجّله إلى أول دفعة.
الخطوة 2. أنشئ منتجاتك
في lava.top أنشئ منتجاً لكل خطة تبيعها.
- للخطة المتكرّرة اختر نوع المنتج «اشتراك» — عندها تخصم lava.top بنفسها، وكل تجديد يمدّد الوصول لدينا.
- للشراء لمرة واحدة استخدم منتجاً رقمياً أو دورة أو استشارة بسعر ثابت.
- أضف إلى العرض سعراً بعملة واحدة مدعومة على الأقل: RUB أو USD أو EUR. عملة الخطة في CreateYourVPN هي الاختيار الافتراضي، لكن العميل يستطيع التبديل إلى أي عملة متاحة في العرض.
- طابِق دورة الخصم مع مدة الخطة: منتج شهري ↔ 30 يوماً، 90 يوماً ↔ 90، وهكذا.
- أخفِ المنتجات عن صفحتك العامة في lava.top بإعداد الظهور «مخفي» فقط. لا تفعّل «السعر عند الطلب عبر API»: تكاملنا ينشئ دفعات من عروض ذات سعر ثابت ولا يرسل المبلغ عبر API. ينبغي أن يمرّ البيع عبر واجهتك: الشراء مباشرة قد يصل بلا علامتنا ويبقى «بلا ربط». أما المنتجات المخفية ذات السعر الثابت فتبقى ظاهرة في مُحدِّد العروض.
تسمّي lava.top سعر المنتج عرضاً (offer). قد يكون للمنتج الواحد عدة عروض (عملات ومدد مختلفة) — وهو العرض نفسه الذي ستختاره لاحقاً لكل خطة.
ماذا يحدث عند الشراء المتكرّر
المنتج لمرة واحدة لا تجديد فيه: حين يحتاج العميل إلى المزيد يشتري ببساطة من جديد. هذا سيناريو طبيعي، والشراء مسبقاً آمن — تُضاف الأيام إلى الرصيد المتبقّي ولا تُحسب من جديد. عشرة أيام متبقّية زائد شهر جديد تعطي أربعين يوماً.
استثناء واحد إذا كانت الخطة تمنح أيضاً حركة بيانات: تُستبدل الحصة ولا تُجمع. العميل الذي اشترى 100 غيغابايت واستهلك 30 ثم اشترى الخطة نفسها مجدداً يحصل على 100 غيغابايت جديدة، لا 170. ضع ذلك في حسبانك عند تسعير خطط الحركة.
الخطوة 3. اربط الحساب في CreateYourVPN
كل ما يلزم من جهة lava.top موجود في مكان واحد: Integrations في القائمة الجانبية، بطاقة API.

أنشئ مفتاح API
افتح بطاقة API واضغط «Create API key». يُعرض المفتاح مرة واحدة فقط — انسخه فوراً: لن تعرضه lava.top مرة ثانية، والمفتاح المفقود لا يمكن إلا استبداله بآخر جديد.

الصق المفتاح في لوحتك
في CreateYourVPN افتح قسم «التحقيق المالي»، اضغط «ربط» في بطاقة lava.top، والصق المفتاح في حقل «مفتاح API الخاص بـ lava.top» ثم احفظ.
نتحقّق من المفتاح فوراً ونجيب إمّا «تم قبول المفتاح» — مع عدد المنتجات الموجودة في الحساب — أو «لم تقبل lava.top هذا المفتاح».
بعد الحفظ مباشرة تظهر في النموذج نفسه قيمتان إضافيتان: عنوان الويب هوك ومفتاح الويب هوك. هاتان القيمتان ستلصقهما في lava.top في الخطوة التالية. مفتاح الويب هوك نولّده نحن — لا داعي لابتكار شيء.
أضف الويب هوك
تقترح lava.top ذلك مباشرة بعد إنشاء المفتاح — اضغط «+ Add Webhook». الزر نفسه متاح لاحقاً في صفحة API.

يكفي ويب هوك واحد — ففي حقل نوع الحدث تُحدَّد كل الأنواع المطلوبة دفعة واحدة:

URL — عنوان الويب هوك من لوحتك. تقبل lava.top HTTPS فقط؛ وعنواننا كذلك بالفعل.
Event type — حدِّد كلا النوعين: «Payment result» و**«Recurring payment»**. القائمة تسمح بالاختيار المتعدد، فلا حاجة إلى ويب هوك ثانٍ.
Type of authentication for Webhook — اختر «API key of your service» والصق في حقل «API key» مفتاح الويب هوك من اللوحة. (Basic يصلح أيضاً — نقبله — لكنه حقلان بدل حقل واحد.)
Comment — اختياري، لك أنت: ملاحظة مثل «CreateYourVPN — المدفوعات» تفيد حين تكون لديك عدة تكاملات.
لا يوجد لدى lava.top توقيع للطلب إطلاقاً، ولذلك مفتاح الويب هوك هو ما يخبر مستقبِلنا بأن التسليم جاء من حسابك — تعامل معه كأنه كلمة مرور.
لا تُلغِ تحديد «Recurring payment» إن كنت تبيع اشتراكات: بدون هذا النوع من الأحداث لا تصلنا التجديدات وينتهي وصول العميل الدافع من تلقاء نفسه. أما للمنتجات لمرة واحدة فيكفي «Payment result»، ومع ذلك يمكنك ترك النوعين محدَّدين بأمان.
ماذا يمنحنا مفتاح API
لا توجد لدى lava.top مفاتيح «للقراءة فقط» — فمفتاح API يمنح وصولاً كاملاً إلى حساب المؤلّف. نستخدمه لثلاثة أمور بالضبط: إنشاء الدفعة لحظة ضغط العميل على «ادفع»؛ وقراءة كتالوج منتجاتك من أجل مُحدِّد العروض؛ وإلغاء الاشتراك حين يوقف العميل التجديد التلقائي من لوحته. لا نغيّر الأسعار، ولا نمسّ تصدير مبيعاتك، ولا نفعل شيئاً آخر بهذا المفتاح. يُخزَّن المفتاح مشفّراً، ولا يُعرض مرة أخرى في أي مكان، ولا يظهر في سجلاتنا. وإن أردت قطع الوصول — احذف الربط من اللوحة، فيُحذف المفتاح معه.
الخطوة 4. اربط العروض بالخطط
افتح «الخطط»، ادخل إلى خطة وابحث عن كتلة lava.top:
اضغط «تحميل المنتجات» — سنجلب الكتالوج من حسابك في lava.top.
اختر العرض الذي تُباع به هذه الخطة. تُظهر القائمة المنتج والسعر ودورة الخصم.
راجع التحذيرات إن ظهرت. ستخبرك اللوحة حين لا يكون للعرض سعر بعملة الخطة، وحين تختلف دورة الخصم عن مدة الخطة («يخصم كل 30 يوماً، بينما تمنح الخطة 365»).
أنشأت منتجاً للتو في lava.top ولا تراه في القائمة؟ اضغط «تحديث القائمة» — يُخزَّن الكتالوج مؤقتاً لمدة دقيقة.
يختار العميل أي عملة متاحة في العرض. في الدفعة لمرة واحدة بالروبل تظهر البطاقة وSBP، وفي الاشتراك بالروبل تظهر البطاقة فقط؛ أما الدولار واليورو فيدعمان البطاقة وPayPal.
الخطوة 5. تحقّق بدفعة حقيقية
اشترِ أرخص خطة بنفسك من حساب عميل في واجهتك. خلال دقيقة ينبغي أن تظهر الخطة في ذلك الحساب، وأن تظهر الدفعة في السجلّ بحالة «معالَج» (قسم «التحقيق المالي»).
إن لم يحدث ذلك:
- الحدث غير موجود في السجلّ إطلاقاً — الويب هوك في lava.top يشير إلى عنوان خاطئ، أو أن أنواع الأحداث المطلوبة غير محدَّدة فيه، أو أن مفتاح الويب هوك لا يطابق ما في اللوحة. لدى lava.top سجلّ للويب هوك مع زر إعادة إرسال — ابدأ منه؛
- الحدث موجود لكنه «بلا ربط» — لم نعرف لمن الدفعة ولا لأي خطة. اربطها يدوياً في السجلّ نفسه: سيُمنح الاشتراك بالشيفرة ذاتها المستخدمة في الدفع التلقائي؛
- «يحتاج انتباهاً» — الدفعة تتطلّب قراراً بشرياً: العميل محظور في لوحتك، أو أن الخطة انتقلت إلى منتج آخر في lava.top بعد إنشاء الدفعة. نحن هنا لا نمسّ الوصول من تلقاء أنفسنا — القرار لك.
فشل الخصم ليس داعياً للقلق: ستعيد lava.top المحاولة بعد 8 ساعات ثم بعد 24 ساعة، ولن نقطع الوصول بسبب محاولة فاشلة. لا ترسل lava.top إشعار الفشل إلا بعد المحاولة الأخيرة؛ وإذا أُلغي الاشتراك فلن يحدث التجديد التالي، بينما تستمر المدة المدفوعة حتى نهايتها.
عن المال
- عمولة lava.top هي 8 % من كل دفعة ناجحة. تُخصم فوراً ولا تُعاد عند ردّ المبلغ للعميل.
- الاسترداد يتم من لوحة lava.top، قسم «المبيعات»؛ والاسترداد على اشتراك يُلغي الاشتراك. لا يوجد حتى الآن نوع ويب هوك خاص بالاستردادات والمنازعات في lava.top، لذا ستراها في لوحة lava.top لا في سجلّنا.
- إلغاء التجديد التلقائي. يستطيع العميل إلغاءه بنفسه من لوحته في واجهتك — عندها نطلب من lava.top إلغاء الاشتراك — أو من حسابه في lava.top؛ ويمكنك أنت أيضاً إلغاؤه نيابة عنه من لوحتك في lava.top. الإلغاء لا يسلب الوصول: يبقى سارياً حتى نهاية المدة المدفوعة، ونحن ببساطة نتوقف عن انتظار الخصم التالي.
- المنازعة (chargeback) يمكن رفعها خلال 540 يوماً من الدفع، ولديك 3 أيام لتقديم الأدلة. احتفظ بشروط واجهتك وبمراسلاتك مع العميل — هكذا تبدو الأدلة.
- حدود الدفعة: الحد الأدنى دائماً 50 ₽ / 5 $ / 5 €. الحد الأقصى للاشتراكات 300 000 ₽ / 3 000 $ / 3 000 €، وللمنتجات لمرة واحدة 1 000 000 ₽ / 10 000 $ / 10 000 €.
إذا تسرّب مفتاح
في بطاقة lava.top زرّان مختلفان، ولكل منهما وظيفة مختلفة:
- «تجديد مفتاح الويب هوك» — يصدر مفتاحاً جديداً للإشعارات الواردة. يجب لصق القيمة الجديدة في الويب هوك في lava.top؛ وإلى أن تفعل ذلك لن تُؤكَّد المدفوعات.
- «تدوير رابط الـ webhook» — يصدر عنواناً جديداً. يتوقّف القديم عن العمل فوراً، ويجب تحديثه هو أيضاً في الويب هوك.
وإن تسرّب مفتاح API نفسه — ألغِه في lava.top، وأنشئ مفتاحاً جديداً والصقه في اللوحة.
كيفية إعداد خادمك الخاص (وضع «خادم واحد»)
دليل خطوة بخطوة: كيف تربط خادمك الافتراضي (VPS) بـ CreateYourVPN في وضع «خادم واحد» — من استئجار الخادم إلى الحصول على VPN شخصي جاهز خلال دقائق.
Happ
كيفية تثبيت تطبيق Happ على هاتفك أو حاسوبك، وماذا تفعل إذا كان غير متوفر في بلدك، وكيفية الاتصال باستخدام الرابط الموجود في حسابك.