جميع الإضافات
التجارة الإلكترونية

Keygen

مفتاح ترخيص من Keygen لكل منتج رقمي تبيعه

ماذا تفعل

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

لمن يناسب

للمطورين والاستوديوهات الصغيرة التي تبيع تطبيقات سطح المكتب أو الإضافات أو الألعاب أو غيرها من البرمجيات القابلة للتنزيل عبر متجرها على VeloCMS، وتدير التراخيص أصلًا في حساب على Keygen. ستحتاج إلى رقم حسابك في Keygen، ورمز منتج أو مسؤول، وسياسة واحدة على الأقل. وتناسب من يريد أن يكون المفتاح في يد المشتري فور الدفع بدل إرسال المفاتيح يدويًا من جدول بيانات.

كيف تعمل

  1. أدخل رقم حسابك في Keygen ورمز API ومعرّف سياسة افتراضية، واختياريًا خريطة JSON تربط منتجات بعينها بسياسات أخرى. ثم احفظ، وبعد ذلك شغّل «اختبار الاتصال».

  2. يُكمل العميل عملية شراء. وبعد أن يتأكد الدفع، تقرأ الإضافة بنود الطلب وتنتقي منها البنود التي يكون نوع منتجها رقميًا أو ترخيصًا.

  3. ولكل بند من هذه البنود تبحث الإضافة عن السياسة (ربط المنتج أولًا ثم السياسة الافتراضية) وتنشئ ترخيصًا في Keygen. أما البنود التي لا سياسة لها على الإطلاق فتُتخطى مع تحذير.

  4. تُكتب المفاتيح التي يعيدها Keygen في الطلب نفسه. ويراها المشتري، مسمّاة بعنوان المنتج، في صندوق «مفاتيح الترخيص» ضمن صفحة حالة طلبه.

  5. وإن استُرد الطلب لاحقًا أو اعترض العميل على الدفع لدى مصرفه (chargeback)، ترسل الإضافة طلب إيقاف إلى Keygen لكل مفتاح محفوظ في ذلك الطلب.

الإعدادات التي تضبطها

إصدار مفاتيح الترخيص عند الشراء
مفعّل افتراضيًا. أوقفه لمنع إنشاء تراخيص جديدة ولمنع إيقاف التراخيص المستردة، مع بقاء بقية قيمك المحفوظة كما هي.
رقم الحساب
الاسم المختصر لحسابك في Keygen أو رقمه، ويظهر ضمن Account Settings في Keygen. وهو جزء من عنوان كل طلب يُرسَل إلى Keygen.
رمز API
رمز منتج أو رمز مسؤول يُنشأ ضمن Tokens في Keygen. يُشفَّر عند الحفظ، ثم يعرض الحقل بعده نصًّا نائبًا لا القيمة الحقيقية.
رقم السياسة الافتراضية
سياسة Keygen التي تُستخدم لأي منتج رقمي غير مدرج في الربط. ويحتاج «اختبار الاتصال» إليها أيضًا.
ربط المنتج بالسياسة
اختياري. كائن JSON مفاتيحه أرقام منتجات VeloCMS وقيمه أرقام سياسات Keygen. ويفشل الحفظ إذا لم يكن النص المُدخل كائن JSON صالحًا.
اختبار الاتصال
ينشئ ترخيصًا حقيقيًا باسم VeloCMS Connection Test على سياستك الافتراضية. فإذا نجح، فألغِ ذلك الترخيص التجريبي من لوحة تحكم Keygen.

ما تستطيع الوصول إليه

بعد أن يُدفع الطلب، تقرأ الإضافة معرّف الطلب وبريد المشتري وبنود الطلب مع معرّفات منتجاتها وأنواعها. ولا ترسل أبدًا سوى طلبات POST، ولا ترسلها إلا إلى api.keygen.sh، وذلك لإنشاء التراخيص أو لإيقافها. ويُحفظ رمز Keygen مشفّرًا في إعدادات موقعك ولا يُعاد إلى المتصفح أبدًا. وتُخزَّن المفاتيح المُصدَرة في سجل الطلب نفسه.

الأذونات

  • قراءة إجمالي الطلب وبريد العميل الإلكتروني وبنوده بعد الشراء
  • إصدار مفاتيح ترخيص البرامج لمنتجات الترخيص الرقمية
  • إجراء اتصالات شبكية بـ api.keygen.sh
  • تخزين رمز واجهة برمجة تطبيقات Keygen الخاص بك بشكل مشفّر

الوصول إلى الشبكة الخارجية

ترسل هذه الإضافة طلبات إلى النطاقات التالية:

  • api.keygen.sh

الإمكانات

  • قراءة بيانات التجارة
  • طلبات شبكة خارجية
  • أقسام في الإعدادات
  • order:afterCreate

لقطات الشاشة

نموذج إعدادات Keygen في الإدارة بحقل رمز واجهة البرمجة ومحرّر يربط كل منتج بسياسة ترخيصه
اضبط رمز واجهة برمجة تطبيقات Keygen واربط كل منتج بسياسة الترخيص الخاصة به.

حدود نذكرها بصراحة

  • لا يحصل على مفتاح إلا البنود التي يكون نوع منتجها رقميًا أو ترخيصًا. أما البنود المادية والمختلطة فتُتجاوز، حتى لو كانت في السلة نفسها.

  • مع ضبط سياسة افتراضية يحصل كل منتج من النوع رقمي أو ترخيص على ترخيص، بما في ذلك الكتب الإلكترونية وغيرها من التنزيلات غير البرمجية. اترك الافتراضية فارغة واعتمد الربط وحده إن كان بعض المنتجات فقط يحتاج ترخيصًا.

  • تظهر المفاتيح في صفحة حالة طلب المشتري، ولا تُضاف إلى رسالة تأكيد الطلب المرسلة بالبريد.

  • ينتهي وقت كل طلب إلى Keygen بعد 10 ثوانٍ. والطلب الفاشل يُسجَّل ويظهر في صفحة «نشاط المزامنة» لكنه لا يُعاد، ولا تُمنع عملية الشراء نفسها أبدًا.

  • لا تُنشأ التراخيص إلا لعمليات الشراء التي تتم بعد إعداد الإضافة. أما الطلبات الأقدم فلا تتلقى مفاتيح بأثر رجعي.

  • تُصدر الإضافة التراخيص وتوقفها. ولا تتولى تفعيل الأجهزة ولا التجديد ولا التحقق من الترخيص، وتبقى هذه الأمور في Keygen وفي برمجياتك.

الأسئلة الشائعة

هل يُنشئ إشعار دفع مكرر مفتاحًا ثانيًا؟

لا. يُتخطى أي بند يحمل مفتاحًا بالفعل، ولذلك لا يمكن للطلب نفسه أن ينتج تراخيص مكررة لبند واحد.

ما مصير المفاتيح حين أسترد طلبًا؟

يؤدي الاسترداد أو نزاع الدفع (chargeback) إلى إرسال طلب إيقاف إلى Keygen لكل مفتاح محفوظ في ذلك الطلب. وإن أبلغ Keygen أن الترخيص موقوف أو محذوف من قبل، عُدّ ذلك منجَزًا.

هل يمكن لمنتجات مختلفة أن تستعمل سياسات Keygen مختلفة؟

نعم. اذكر في الربط كل رقم منتج مع رقم السياسة الخاصة به. وأي منتج غير مدرج يرجع إلى السياسة الافتراضية، وإن لم توجد أيٌّ منهما يُتخطى البند بدلًا من أن يُعطى ترخيصًا خاطئًا.

لماذا ينشئ «اختبار الاتصال» ترخيصًا؟

لأن Keygen لا يوفّر نقطة ping بسيطة، فيُنشئ الاختبار ترخيصًا حقيقيًا على سياستك الافتراضية. وهذا أصدق دليل على أن الرمز والحساب والسياسة تعمل معًا كما ينبغي.

المواصفات

الفئة
التجارة الإلكترونية
السعر
مضمَّن
الإصدار
1.0.0
المصدر
من الطرف الأول

تصفّح المزيد من التكاملات

58 تكامل أصلي مجاني متاح.

عرض جميع التكاملات