إدراج الوصول والشراكة
كيف تعرض منصتك أو أداتك في تبويب الوصول على سوق الكنز—من إنشاء القائمة إلى تفعيل الشراء لدى منتجك.
ما هو الوصول؟
الوصول كتالوج منفصل عن الخدمات والمنتجات الرقمية. المشتري يدفع عبر محفظة الكنز، ثم يُفعَّل وصوله لمنتج شريك خارجي (مرة واحدة أو اشتراك).
- الدفع يحدث على الكنز.
- منتجك يفتح الصلاحية عبر تكامل الشريك (webhook / تحقق).
ليس نفس «الدفع بمحفظة الكنز» على موقعك—ذلك مسار Mode A في المطورين.
لمن هذا الدليل؟
- بائع يريد عرض اشتراك أو تفعيل لمنصة خارجية داخل تبويب الوصول.
- فريق منتج يحتاج خطوات واضحة قبل قراءة وثائق الـ API.
خطوات الإدراج (البائع)
- سجّل وادخل لوحة التحكم.
- افتح الوصول ← بيع وعروضي (
/dashboard/access?tab=sell). - أنشئ قائمة: عنوان عربي واضح، وصف، سعر، ووضع الفوترة (لمرة واحدة أو شهري/سنوي).
- املأ حقول الشريك عند التوفر:
- مرجع خارجي (external_ref) — رمز الخطة/SKU لديك. - رابط Webhook — لاستقبال access.paid / access.renewed / access.expired. - سر الشريك — لتوقيع الـ webhook والتحقق. - رابط المطالبة (claim_url) اختياري — صفحة الشريك التي يفتحها المشتري في تبويب جديد بعد الدفع (?claim=…).
- أرسل للمراجعة لدى المشرف العام. العروض الجديدة تبدأ بحالة
pending_reviewوتُنشر فقط بعد الموافقة. تعديلات العرض النشط تحتاج مراجعة أيضاً (العرض الحالي يبقى ظاهراً حتى تُعتمد التغييرات).
لا حاجة لنموذج شراكة منفصل—الثقة تُبنى من وضوح العرض والتكامل الموثوق ومراجعة المشرف قبل النشر.
بعد الشراء (المشتري)
- يشحن المحفظة ويدفع للقائمة.
- يفعّل منتجك الصلاحية (يفضّل من الـ webhook دون لصق مفتاح).
- عند ضبط رابط المطالبة، يفتح الكنز رابط الشريك في تبويب جديد. الرابط لمرة واحدة وقصير العمر؛ يمكن للمشتري إصدار رابط جديد لاحقاً من شراء ووصولي.
- مفتاح الوصول يبقى متاحاً كاحتياطي.
تفاصيل المستحقات والاحتجاز كما في بقية مبيعات المنصة—راجع المحفظة والتسعير.
التكامل التقني
للمطورين: توقيع HMAC، أشكال الأحداث، verify-entitlement، تبادل المطالبة / إعادة الإصدار، والتحقق بالمفتاح في دليل الشريك:
نصائح لقائمة مقنعة
- اشرح ماذا يفتح المشتري بعد الدفع، لا اسم المنتج فقط.
- حدّد إن كان التفعيل فورياً أو يحتاج حساباً على منصتك.
- اختبر webhook محلياً قبل الإطلاق؛ عالج تكرار
event_idوألغِ عندaccess.expired.