الانتقال إلى المحتوى الرئيسي
أصدر مفاتيح فريدة لبرنامجك أو سلعك الرقمية، وتحكَّم في التفعيلات، وألغِ الوصول عند الحاجة. تتكامل مفاتيح الترخيص بشكل جيد مع الاشتراكات وعمليات الشراء لمرة واحدة.

ما هي مفاتيح الترخيص؟

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

الفوائد الرئيسية

  • التحكم في الوصول: تحديد تاريخ انتهاء الصلاحية وحدود التفعيل
  • الرؤية التشغيلية: تتبع الاستخدام، الأجهزة، والتاريخ
  • الأمان والدعم: تعطيل، إعادة تفعيل، وتدقيق بسرعة

إنشاء مفاتيح الترخيص

1

Create a License Key

انتقل إلى لوحة Dodo Payments الخاصة بك وافتح قسم مفاتيح الترخيص. اختر خيار إنشاء مفتاح ترخيص جديد.
2

Configure License Key Settings

حدِّد كيفية إصدار مفاتيح الترخيص واستخدامها عن طريق التعيين في هذه الحقول:
  • تاريخ انتهاء صلاحية مفتاح الترخيص: حدد مدة صلاحية المفتاح. اختر مدة معينة (على سبيل المثال، 30 يومًا أو سنة واحدة)، أو اختر “بدون انتهاء” لمفتاح دائم.
  • حد التفعيل: عيِّن الحد الأقصى لعدد التفعيلات المتزامنة لكل مفتاح. استخدم رقمًا محددًا لحالات مثل الترخيص الفردي (1) أو تراخيص الفريق (5)، أو اختر “غير محدود” لعدم وضع حد لعدد التفعيلات.
  • تعليمات التفعيل: قدِّم خطوات تفعيل واضحة لعملائك، والتي سيتم إرسالها أيضًا عبر البريد الإلكتروني مع مفتاح الترخيص. أمثلة: “ألصق المفتاح في الإعدادات → الترخيص” أو “شغِّل: mycli activate <key>”.
3

Review and Save

راجع جميع التفاصيل المدخلة. عندما تكون جاهزًا، احفظ إعدادات مفتاح الترخيص لإتمام إنشاء المفتاح.
استخدم تعليمات واقعية وأضف روابط الدعم لتقليل تذاكر التفعيل.
Creating a license key in Dodo Payments dashboard

إدارة ومراقبة

يوفر قسم مفاتيح الترخيص عرضًا شاملاً لجميع أنشطة مفاتيح الترخيص ويمكّنك من إدارة ومراقبة التراخيص بفعالية.

معلومات المفتاح

عرض معلومات مفصلة لكل مفتاح ترخيص:
  • تفاصيل المفتاح: قيمة مفتاح الترخيص، اسم المنتج المرتبط، تفاصيل العميل (customer_id)، وتاريخ الشراء
  • نشاط الاستخدام: عدد التفعيلات، تواريخ وأوقات التفعيل، والحالة (نشط، منتهي، معطل)
  • الانتهاء والحدود: تاريخ انتهاء صلاحية المفتاح، عدد التفعيلات المتبقية، وحالات التفعيل الحالية
License key details

الإجراءات المتاحة

يمكنك تنفيذ الإجراءات التالية على مفاتيح الترخيص:
  • تعطيل مفتاح الترخيص: تعطيل المفتاح على الفور لمنع المزيد من الاستخدام
  • تمكين المفتاح: إعادة تفعيل مفتاح الترخيص المعطل سابقًا
  • عرض حالات التفعيل: رؤية جميع حالات التفعيل المرتبطة بمفتاح ترخيص معين
License key actions

الفوائد

  • تتبع نشاط مفتاح الترخيص في الوقت الفعلي
  • تحديد الاستخدام غير المصرح به أو التفعيلات غير المصرح بها
  • تبسيط دعم العملاء من خلال توفير سجلات استخدام مفصلة في حالة وجود أي تناقض

إدارة واجهة برمجة التطبيقات

استخدم هذه الواجهات لتفعيل، والتحقق، وإدراج، وتحديث مفاتيح الترخيص وحالات تفعيلها.
النقاط النهائية العامة: تعد نقاط النهاية الخاصة بتفعيل ووقف التفعيل والتحقق من الترخيص عامة ولا تتطلب مفتاح API. يتيح لك ذلك استدعاءها مباشرة من تطبيقات العملاء أو برامج سطح المكتب أو واجهات سطر الأوامر دون كشف بيانات اعتماد API الخاصة بك.

أمثلة على التكامل

تفعيل ترخيص

هذه النقاط النهائية لا تتطلب مفتاح API ويمكن استدعاؤها مباشرة من تطبيقات العملاء لديك.
import DodoPayments from 'dodopayments';

// No API key needed for public license endpoints
const client = new DodoPayments();

const response = await client.licenses.activate({ 
  license_key: 'license_key', 
  name: 'Device Name' 
});

console.log(response.id);

التحقق من ترخيص

import DodoPayments from 'dodopayments';

// No API key needed for public license endpoints
const client = new DodoPayments();

const response = await client.licenses.validate({ 
  license_key: '2b1f8e2d-c41e-4e8f-b2d3-d9fd61c38f43' 
});

console.log(response.valid);

مفاتيح الترخيص في عنوان العودة

عند إتمام العميل عملية شراء لمنتج مفعَّل بمفاتيح ترخيص، تتم إضافة مفتاح الترخيص تلقائيًا إلى return_url كمعامل استعلام. يتيح لك ذلك عرض المفتاح فورًا في صفحة النجاح بدون إجراء نداء API إضافي.
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com
إذا أنشأت عملية الشراء عدة مفاتيح ترخيص (مثلًا، الكمية > 1)، فستُفصل المفاتيح بفواصل:
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001,LK-002&email=customer%40example.com
بالنسبة للاشتراكات، يُستخدم subscription_id بدلًا من payment_id:
https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001&email=customer%40example.com
حلل معامل license_key في صفحة العودة لعرض المفتاح فورًا للعملاء، مما يحسن تجربة ما بعد الشراء.

أفضل الممارسات

  • حافظ على حدود واضحة: اختر إعدادات افتراضية معقولة للانتهاء والتفعيلات
  • وجِّه المستخدمين: قدِّم تعليمات تفعيل دقيقة ووثائق للخدمة الذاتية
  • أتمتة التحقق: تحقّق من المفاتيح من جهة الخادم قبل منح الوصول
  • راقب الأحداث: استخدم الـ webhooks لاكتشاف الإساءة وأتمتة الإلغاءات