CreateYourVPN Academy
الأدلة

قبول المدفوعات عبر lava.top

دليل خطوة بخطوة: كيف تربط lava.top مع CreateYourVPN ليشحن عملاؤك رصيدهم في متجرك. مفتاح API، والويب هوك، ومبالغ الشحن، والشحن التلقائي.

lava.top تقبل البطاقات وSBP وPayPal بالروبل والدولار واليورو. عبرها يشحن عملاؤك رصيدهم في حسابهم على متجرك، ومن هذا الرصيد يشترون الخطط: لا حاجة لمنح الوصول يدوياً.

تعمل lava.top بمبالغ ثابتة: يختار العميل أحد مبالغ الشحن التي تضيفها أنت، ولكل مبلغ عرضه الخاص بالسعر نفسه. ولا يستطيع العميل إدخال مبلغ من عنده. وإن احتجت إلى أي مبلغ، فاربط PayHot أيضاً.

تذهب الأموال إلى حسابك أنت في lava.top. CreateYourVPN ليست وسيطاً في المدفوعات ولا تأخذ عمولة من مبيعاتك.

قبول المدفوعات متاح في خطة Max المدفوعة: فيها يبدأ متجرك البيع، ويُفعَّل رصيد العملاء تلقائياً. عن أسعار المنصّة انظر درس الفوترة.

ما ستحتاج إليه

  • حساب على lava.top (حساب مؤلّف، أي الحساب الذي يبيع)؛
  • 10–15 دقيقة للإعداد الأولي؛
  • مبلغ صغير لشحن تجريبي: لا يوجد لدى lava.top وضع تجريبي، والطريقة الوحيدة للتحقّق من الإعداد كاملاً هي دفعة حقيقية (الحد الأدنى 50 ₽ / 5 $ / 5 €).

الخطوة 1. التسجيل والتحقّق

سجّل في lava.top واملأ ملفك الشخصي: فمع ملف فارغ تبدو صفحة الدفع للمشتري غير مكتملة.

ثم ادخل إلى Balance ← التحقّق وأكمله: وثيقة وصورة ذاتية، 18+، دون تشغيل VPN.

البيع ممكن حتى قبل التحقّق، أما سحب الأموال فلا يتم بدونه. لا تؤجّله إلى أول سحب.

الخطوة 2. أنشئ منتجاتك

سعر العرض في lava.top هو مبلغ الشحن نفسه. أنشئ من العروض بعدد المبالغ التي تريد أن تقدّمها لعملائك.

  • الشحن لمرة واحدة: منتج رقمي أو دورة أو استشارة بسعر ثابت. العرض الواحد يعطي مبلغاً واحداً، مثل 300 أو 500 أو 1000 ₽.
  • الشحن التلقائي: منتج من نوع «اشتراك». تخصم lava.top بنفسها سعر العرض وفق جدوله (كل شهر، أو كل 3 أشهر، أو كل 6 أشهر، أو كل سنة)، وكل خصم يشحن رصيد العميل.
  • يجب أن يكون للعرض سعر بعملة حساب العملاء. تجد العملة في قسم «التحقيق المالي»، في بطاقة «رصيد العملاء». تقبل lava.top الروبل والدولار واليورو.
  • أخفِ المنتجات عن صفحتك العامة في lava.top باختيار الظهور المخفي. لا تفعّل «السعر عند الطلب عبر API»: تعمل CreateYourVPN مع العروض ذات السعر الثابت. الشراء مباشرة من صفحتك في lava.top يصل بلا علامتنا، ولن نعرف لمن هذه الدفعة. أما المنتجات المخفية ذات السعر الثابت فتبقى متاحة في لوحتك.

العرض (offer) في lava.top هو طريقة لبيع منتج بسعر محدد وفترة خصم محددة. قد يكون للمنتج الواحد عدة عروض، وفي لوحتك تختار العرض المناسب لكل مبلغ.

الخطوة 3. اربط الحساب في CreateYourVPN

كل ما يلزم من جهة lava.top موجود في مكان واحد: Integrations في القائمة اليسرى، بطاقة API.

قسم «Integrations» في lava.top: بطاقتا API وWeb-Widget

أنشئ مفتاح API

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

صفحة مفاتيح API: زر «Create API key» ورابط سجلّ الويب هوك

الصق المفتاح في لوحتك

في CreateYourVPN افتح قسم «التحقيق المالي»، واضغط «ربط» في بطاقة lava.top، والصق المفتاح في حقل «مفتاح API الخاص بـ lava.top» ثم احفظ.

نتحقّق من المفتاح فوراً ونجيب إمّا «تم قبول المفتاح» مع عدد المنتجات الموجودة في حسابك، أو «لم يقبل lava.top هذا المفتاح».

بعد الحفظ مباشرة تظهر في النموذج نفسه قيمتان إضافيتان: Webhook URL ومفتاح الويب هوك. هاتان القيمتان ستلصقهما في lava.top في الخطوة التالية. مفتاح الويب هوك نولّده نحن، فلا داعي لابتكار شيء.

أضف الويب هوك

تقترح lava.top ذلك مباشرة بعد إنشاء المفتاح: اضغط «+ Add Webhook». الزر نفسه متاح لاحقاً في صفحة API.

نافذة «API key successfully added» مع زر «+ Add Webhook»

يكفي ويب هوك واحد: في حقل «نوع الحدث» تُحدَّد كل الأحداث دفعة واحدة.

نموذج إضافة ويب هوك: العنوان ونوع الحدث ونوع المصادقة وحقل مفتاح API

URL: عنوان الويب هوك من لوحتك. تقبل lava.top عناوين HTTPS فقط، وعنواننا كذلك.

نوع الحدث: حدّد كل الأحداث في القائمة. الاختيار متعدّد، فلا حاجة إلى ويب هوك ثانٍ.

Type of authentication for Webhook: اختر «API key of your service» والصق مفتاح الويب هوك من لوحتك في حقل «API key». ويصلح Basic أيضاً، فنحن نقبله، لكنه حقلان بدل حقل واحد.

Comment: اختياري، لك أنت. ملاحظة مثل «CreateYourVPN، المدفوعات» تفيد حين تكون لديك عدة تكاملات.

لا تضيف lava.top توقيعاً تشفيرياً لجسم الطلب، ولذلك فمفتاح الويب هوك هو ما يثبت صحة التسليم. تعامل معه كأنه كلمة مرور.

لا تترك أي حدث دون تحديد: فبدون أحداث الدفعات المتكرّرة لن يصل الشحن التلقائي لعملائك إلى رصيدهم. تحديد كل الأحداث آمن دائماً.

ماذا يمنحنا مفتاح API

لا توجد لدى lava.top مفاتيح «للقراءة فقط»: فمفتاح API يمنح وصولاً كاملاً إلى حساب المؤلّف. نستخدمه لثلاثة أمور بالضبط: إنشاء الدفعة لحظة ضغط العميل على «ادفع»؛ وقراءة كتالوج منتجاتك لتختار العروض في لوحتك؛ وإلغاء الاشتراك حين يوقف العميل الشحن التلقائي أو التجديد التلقائي في حسابه. لا نغيّر الأسعار، ولا نصدّر مبيعاتك، ولا نفعل شيئاً آخر بهذا المفتاح. يُخزَّن المفتاح مشفّراً، ولا يُعرض مرة أخرى في أي مكان، ولا يظهر في سجلاتنا. وإن أردت قطع الوصول، فاحذف الربط من لوحتك: يُحذف المفتاح معه.

الخطوة 4. أضف مبالغ الشحن

افتح «الخطط» وابحث عن كتلة «شحن الرصيد».

اضغط «إضافة شحن»، واختر عرضاً لمرة واحدة من قائمة «عرض lava.top»، ثم اضغط «إضافة شحن» في النافذة. يصبح المبلغ هو سعر العرض. أضف كل مبلغ بهذه الطريقة، حتى 20 مبلغاً.

للشحن التلقائي اضغط «إضافة شحن تلقائي»، واختر اشتراكاً من lava.top، ثم اضغط «إضافة شحن تلقائي» في النافذة. العرض هو الذي يحدّد المبلغ والتكرار، مثلاً 500 ₽ كل شهر. وتخبرك اللوحة بالخطة التي يكفي لها هذا الشحن.

راجع التنبيهات في الصفوف إن ظهرت. تخبرك اللوحة عندما لا يكون للعرض سعر بعملة الرصيد، وعندما يختلف سعر العرض عن المبلغ، وعندما يختفي العرض من lava.top.

أنشأت منتجاً للتو في lava.top ولا تراه في القائمة؟ اضغط «تحديث القائمة»: يُخزَّن الكتالوج مؤقتاً لمدة دقيقة.

ما دمت لم تضف أي مبلغ ولم تربط PayHot، فلن يجد عملاؤك ما يشحنون به رصيدهم: ستعرض لهم نافذة «شحن الرصيد» عبارة «شحن الرصيد غير متاح بعد». أضف مبلغاً واحداً على الأقل لا يقل عن سعر أغلى خطة لديك: عندها يستطيع العميل ذو الرصيد الفارغ أن يشحنه ويشتري الخطة بدفعة واحدة، بزر «اشحن واشترِ».

لا يُختار العرض في الخطة نفسها: فالخطة بعملة الحساب يشتريها العميل من الرصيد. والاستثناء خطة سعرها بعملة أخرى وكانت مرتبطة بعرض من قبل: يدفع العميل ثمنها عبر lava.top مباشرة.

ماذا سيرى العميل

في حسابه على متجرك يضغط العميل «اشحن الرصيد». في تبويب «مرة واحدة» يختار أحد مبالغك وطريقة الدفع: بطاقة، أو SBP (بالروبل فقط)، أو PayPal إذا كان للعرض سعر بالدولار أو اليورو. وفي تبويب «تلقائيًا» يفعّل الشحن التلقائي: بالبطاقة أو عبر PayPal، لأن اشتراكات lava.top لا تقبل SBP. ويصل إلى الرصيد دائماً مبلغ الشحن بعملة الحساب، حتى لو دفع العميل بعملة أخرى.

يحتاج الشحن التلقائي إلى خطة اشتراك لها مدة وسعر بعملة الحساب: بدونها لا يظهر للعميل تبويب «تلقائيًا». ويعمل الشحن التلقائي مع التجديد التلقائي للخطة من الرصيد: عند تفعيل الشحن التلقائي يُفعَّل التجديد التلقائي من تلقاء نفسه، وإن لم تكن لدى العميل خطة بعد، فإن أول خصم يشتريها. وللعميل شحن تلقائي واحد فقط.

الخطوة 5. تحقّق بدفعة حقيقية

من حساب عميل في متجرك، اشحن الرصيد بأصغر مبلغ. خلال دقيقة ينبغي أن تظهر الأموال في الرصيد، وأن يظهر في قسم «التحقيق المالي»، ضمن «سجل المدفوعات»، شحنٌ للرصيد بحالة «معالَج». ثم اشترِ خطة من الرصيد.

إن لم يحدث ذلك:

  • الحدث غير موجود في السجلّ إطلاقاً: الويب هوك في lava.top يشير إلى عنوان خاطئ، أو لم تُحدَّد فيه كل الأحداث، أو أن مفتاحه لا يطابق ما في اللوحة. لدى lava.top سجلّ للويب هوك مع زر إعادة إرسال، فابدأ منه؛
  • الحدث موجود، لكن الأموال ليست في الرصيد: على الحدث ملاحظة «لم يُضف إلى الرصيد» مع تلميح. تحقّق من الدفعة في lava.top وأضف المبلغ بتسوية في بطاقة العميل؛
  • «بلا ربط»: لم نعرف لمن هذه الدفعة. يحدث ذلك حين يشتري العميل منتجاً مباشرة من صفحتك في lava.top متجاوزاً المتجر. ابحث عن العميل وأضف المبلغ بتسوية في بطاقته؛
  • «يحتاج انتباهاً»: الحدث يتطلّب قرارك، والحدث نفسه يوضّح ما يجب فعله.

إذا فشل خصم الاشتراك، تجري lava.top محاولتين إضافيتين، بعد 8 ساعات وبعد 24 ساعة، ولا ترسل إشعار فشل الدفع إلا بعد المحاولة الأخيرة. ويرى العميل في حسابه أن آخر خصم لم ينجح. أما الأموال الموجودة في الرصيد فتبقى للعميل.

عن المال

  • عمولة lava.top هي 8 % من كل دفعة ناجحة. تُخصم فوراً ولا تُعاد إذا رددت المبلغ للعميل لاحقاً.
  • الاسترداد يتم من لوحة 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، وأنشئ مفتاحاً جديداً والصقه في اللوحة.

On this page