مجموعات المنتجات

تتيح لك مجموعات المنتجات تجميع المنتجات ذات الصلة (مثل خطط Starter وPro وEnterprise) ضمن مظلة واحدة. اعرض جميع الخيارات في صفحة دفع واحدة، وحدد مسارات الترقية/الخفض، وامنح العملاء مرونة تبديل الخطط مباشرةً من Customer Portal.

لقطة شاشة لصفحة دفع مجموعة المنتجات تعرض عدة منتجات

أبرز المزايا

هيكل قائم على المجموعات: اجمع المنتجات ذات الصلة (الخطط والشرائح وخيارات التسعير) ضمن مجموعة واحدة لإدارتها بشكل منظم.
مجموعة واحدة ومنتجات متعددة: أدرج منتجات متعددة مثل Starter وPro وLifetime، بحيث يمتلك كل منها نموذج تسعير خاصًا به.
تجربة دفع ديناميكية: اعرض جميع منتجات المجموعة في واجهة دفع واحدة، مما يتيح للعملاء اختيار الخطة المفضلة لديهم.
تحكم على مستوى التاجر: فعّل المنتجات أو عطّلها أو أعد ترتيبها داخل كل مجموعة. يُحدَّد المنتج الأول تلقائيًا مسبقًا عند الدفع.
مراعاة دورة الحياة: مكّن العملاء من الترقية أو الخفض بين المنتجات في المجموعة نفسها عبر Customer Portal.

إنشاء مجموعة منتجات

يمكن إنشاء مجموعات المنتجات وإدارتها من لوحة المعلومات أو عبر API. تعمل كل مجموعة كحاوية للمنتجات ذات الصلة.

Create the collection

حدّد المجموعة باسم ووصف اختياري. حمّل صورة لتمثيل المجموعة بصريًا في صفحة الدفع.

لقطة شاشة لنموذج إنشاء مجموعة المنتجات في لوحة المعلومات تعرض حقول الاسم والوصف وتحميل الصورة

حقول المجموعة:

الاسم (مطلوب): اسم العرض للمجموعة (مثل “خطط SaaS” و”شرائح التراخيص”)
الوصف (اختياري): شرح موجز يظهر في صفحة الدفع
الصورة (اختيارية): الهوية البصرية للمجموعة

Add products to the collection

أضف المنتجات الحالية إلى مجموعتك. يمكن تنظيم المنتجات ضمن مجموعات فرعية لتحسين الهيكل.

لقطة شاشة لصفحة منتجات مجموعة المنتجات تعرض قائمة بالمنتجات وإمكانية إضافتها إلى المجموعة

تنظيم المنتجات:

المجموعات الفرعية: نظّم المنتجات اختياريًا ضمن مجموعات فرعية مسماة (مثل “الخطط الشهرية” و”الخطط السنوية”)
المنتجات غير المجمّعة: تظهر المنتجات التي لا تنتمي إلى مجموعة فرعية على مستوى المجموعة
الترتيب: اسحب العناصر وأفلتها لتحديد ترتيب العرض

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

Configure ordering and visibility

تحكّم في ترتيب عرض المنتجات وإمكانية ظهورها داخل المجموعة.خيارات الإعداد:

حالة المنتج: فعّل المنتجات الفردية داخل المجموعة أو عطّلها
ترتيب العرض: اسحب العناصر وأفلتها لتحديد تسلسل ظهور المنتجات في صفحة الدفع

يُحدَّد المنتج الأول في المجموعة تلقائيًا مسبقًا كافتراضي عند الدفع. أعد ترتيب المنتجات لتغيير المنتج المحدد افتراضيًا.

دفع المجموعة

تتيح المجموعات تجربة دفع موحّدة يمكن للعملاء فيها عرض جميع المنتجات المتاحة واختيار أحدها من مكان واحد.

أنواع الدفع

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

تجربة دفع المجموعة

عند استخدام دفع المجموعة:

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

يُعد دفع المجموعة مثاليًا للأنشطة التجارية القائمة على الاشتراكات التي ترغب في أن يقارن العملاء الخطط جنبًا إلى جنب قبل الشراء.

تكامل API

أنشئ جلسة دفع لمجموعة:

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.checkout_url;

عند استخدام product_collection_id، لا يمكن تطبيق رموز الخصم عند إنشاء الجلسة. ومع ذلك، يمكن للعملاء إدخال رموز الخصم أثناء الدفع إذا كانت مفعّلة.

تكامل Customer Portal

يمكن للعملاء الترقية أو الخفض بين المنتجات داخل المجموعة نفسها مباشرةً من Customer Portal.

هل لديك منتجات اشتراك بالفعل؟ ما عليك سوى إضافتها إلى مجموعة منتجات لتمكين تدفقات الترقية/الخفض في Customer Portal. لا حاجة إلى إعادة إنشاء منتجاتك.

إجراءات إدارة الخطط

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

لقطة شاشة لواجهة تغيير الخطة في بوابة عملاء مجموعة المنتجات تعرض إجراءات إدارة الخطة

قواعد الترقية/الخفض

لا تتوفر الترقية والخفض إلا بين المنتجات داخل المجموعة نفسها
يُطبَّق التوزيع النسبي بناءً على إعدادات اشتراكك
تُرسل إشعارات بالبريد الإلكتروني إلى النشاط التجاري عند كل ترقية أو خفض أو إلغاء

لا يمكن للعملاء التبديل إلى منتجات خارج مجموعتهم الحالية. أنشئ مجموعات منفصلة لخطوط المنتجات المختلفة.

إعدادات الاشتراك

اضبط طريقة عمل الاشتراكات وتغييرات الخطط في نشاطك التجاري من Settings → Subscriptions في لوحة المعلومات.

الإعدادات المتاحة

الإعداد	الوصف	الإعداد الافتراضي
السماح باشتراكات متعددة	يمكن للعملاء الاحتفاظ بأكثر من اشتراك نشط واحد في الوقت نفسه	مفعّل
السماح بتحديثات الاشتراك	يمكن للعملاء ترقية اشتراكاتهم الحالية أو خفضها في أي وقت عبر Customer Portal	معطّل
السماح بإلغاء الاشتراك	يمكن للعملاء إلغاء اشتراكاتهم بأنفسهم من Customer Portal	مفعّل
منع إساءة استخدام الفترة التجريبية	يتم تحويل العملاء الذين سبق لهم استرداد فترة تجريبية إلى عملية شراء مدفوعة من دون فترة تجريبية، بدلًا من منحهم فترة تجريبية جديدة	معطّل

تُعطَّل تغييرات الخطط عبر Customer Portal افتراضيًا. فعّل “Allow Subscription Updates” في Settings → Subscriptions للسماح للعملاء بالترقية أو الخفض بين المنتجات في المجموعة نفسها.

يؤدي إيقاف “السماح بإلغاء الاشتراك” إلى إخفاء خيار الإلغاء الذاتي من العملاء ورفض طلبات الإلغاء المقدمة عبر Customer Portal API. ولا تتأثر عمليات الإلغاء التي تجريها من جانب التاجر. راجع إلغاء اشتراك.

للاطلاع على تفاصيل كيفية مطابقة عمليات استرداد الفترات التجريبية وتسجيلها، راجع منع إساءة استخدام الفترة التجريبية.

Subscription Plan Changes

تعرّف على المزيد حول أوضاع التوزيع النسبي وسلوك تغيير الخطة.

إدارة المجموعات

يمكن إدارة مجموعات المنتجات إما من خلال لوحة تحكم Dodo Payments أو برمجيًا عبر API. يوفر API تحكمًا كاملًا في إنشاء المجموعات وتحديثها ورفع الصور وأرشفتها وإدارة المجموعات والمنتجات المتداخلة.

عمليات لوحة التحكم

إنشاء: إعداد مجموعات جديدة مع المنتجات والمجموعات الفرعية
تحديث: تعديل الاسم والوصف والصورة وتنظيم المنتجات
إعادة الترتيب: السحب والإفلات لتغيير ترتيب عرض المنتجات
تمكين/تعطيل المنتجات: التحكم في المنتجات التي تظهر عند الدفع
الأرشفة: إخفاء مجموعة من دون حذفها نهائيًا (يمكن إلغاء أرشفتها لاحقًا)

لقطة شاشة للوحة تحكم مجموعات المنتجات تعرض عمليات إدارة المجموعة

إدارة API

تتيح نقاط النهاية التالية إنشاء مجموعات المنتجات وتحديثها واستردادها وأرشفتها وتنظيمها برمجيًا — بما في ذلك إدارة المجموعات الفرعية المتداخلة والمنتجات الموجودة فيها.

Listing Product Collections

استرد جميع مجموعات المنتجات المرتبطة بحسابك باستخدام طلب GET إلى نقطة النهاية /product-collections. يدعم ذلك ترقيم الصفحات والتصفية حسب العلامة التجارية وتضمين المجموعات المؤرشفة.

List Product Collections API

اعرض بنية الطلب والاستجابة التفصيلية في وثائق API الخاصة بـ List Product Collections.

Creating a Product Collection

أنشئ مجموعة منتجات جديدة عبر إرسال طلب POST إلى نقطة النهاية /product-collections، مع تفاصيل مثل الاسم والوصف والعلامة التجارية.

Create Product Collection API

اعرض بنية الطلب والاستجابة التفصيلية في وثائق API الخاصة بـ Create Product Collection.

Retrieving a Product Collection

احصل على معلومات تفصيلية حول مجموعة منتجات محددة — بما في ذلك مجموعاتها الفرعية وعناصر المنتجات فيها — باستخدام طلب GET إلى نقطة النهاية /product-collections/{id}.

Get Product Collection API

اعرض بنية الطلب والاستجابة التفصيلية في وثائق API الخاصة بـ Get Product Collection.

Updating a Product Collection

عدّل تفاصيل مجموعة المنتجات (الاسم والوصف والعلامة التجارية وغير ذلك) عبر إرسال طلب PATCH إلى نقطة النهاية /product-collections/{id}.

Update Product Collection API

اعرض بنية الطلب والاستجابة التفصيلية في وثائق API الخاصة بـ Update Product Collection.

Uploading Collection Images

اربط صورة بمجموعة عبر رفعها باستخدام عنوان URL موقّع مسبقًا. اطلب عنوان URL للرفع من نقطة النهاية /product-collections/{id}/images، ثم PUT الصورة إلى عنوان URL المُعاد خلال 60 ثانية.

ينتهي عنوان URL الموقّع مسبقًا بعد 60 ثانية، لذا يجب رفع الصورة خلال هذه المدة.

Update Collection Images API

اعرض بنية الطلب والاستجابة التفصيلية في وثائق API الخاصة بـ Update Collection Images.

Archiving a Product Collection

أرشف مجموعة عبر إرسال طلب DELETE إلى نقطة النهاية /product-collections/{id}. يؤدي ذلك إلى إخفاء المجموعة من الاستخدام الجديد، لكنه لا يزيلها نهائيًا.

Archive Product Collection API

اعرض بنية الطلب والاستجابة التفصيلية في وثائق API الخاصة بـ Archive Product Collection.

Unarchiving a Product Collection

استعد مجموعة مؤرشفة عبر إرسال طلب POST إلى نقطة النهاية /product-collections/{id}/unarchive.

Unarchive Product Collection API

اعرض بنية الطلب والاستجابة التفصيلية في وثائق API الخاصة بـ Unarchive Product Collection.

Managing Groups within a Collection

تتيح لك المجموعات تنظيم المنتجات داخل مجموعة (مثلًا، “الخطط الشهرية” مقابل “الخطط السنوية”). استخدم نقاط نهاية المجموعات لإضافة المجموعات داخل مجموعة أو تحديثها أو حذفها.

إنشاء مجموعة: POST /product-collections/{id}/groups
تحديث مجموعة: PATCH /product-collections/{id}/groups/{group_id}
حذف مجموعة: DELETE /product-collections/{id}/groups/{group_id}

Create Group

أضف مجموعة جديدة إلى مجموعة منتجات.

Update Group

عدّل اسم المجموعة أو سماتها.

Delete Group

أزل مجموعة من مجموعة.

Managing Products within a Group

أدر عناصر المنتجات الفردية داخل مجموعة — أضف منتجات جديدة، وحدّث العناصر الحالية (مثل ترتيب العرض)، أو أزلها بالكامل.

إضافة منتجات إلى مجموعة: POST /product-collections/{id}/groups/{group_id}/items
تحديث عنصر في مجموعة: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
حذف عنصر من مجموعة: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

أضف منتجًا واحدًا أو أكثر إلى مجموعة داخل مجموعة.

Update Group Item

حدّث عنصر منتج داخل مجموعة.

Delete Group Item

أزل عنصر منتج من مجموعة.

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

التجميع المنطقي: نظّم المنتجات حسب فترة الفوترة (شهري/سنوي) أو مستوى الميزات (مبتدئ/احترافي/مؤسسات)
الترتيب الاستراتيجي: ضع الخطة الأكثر شيوعًا أو الموصى بها أولًا، إذ سيتم تحديدها مسبقًا عند الدفع
استخدم أسماء واضحة: يجب أن توضّح أسماء المنتجات فروق القيمة بوضوح
فعّل كلا الاتجاهين: اسمح بالترقيات وخفض الخطط معًا لمنح العملاء مرونة
ضع التوزيع النسبي في الاعتبار: اختر وضع توزيع نسبي يتوافق مع نموذج عملك
اختبر بدقة: تحقّق من مسارات الدفع وتغيير الخطة في وضع الاختبار قبل الإطلاق

أنت مستعد الآن لإنشاء مجموعات المنتجات وتقديم تجربة موحّدة للعملاء لاختيار الخطط.

Products

أنشئ منتجات لمرة واحدة أو منتجات اشتراك أو منتجات قائمة على الاستخدام لإضافتها إلى المجموعات.

Checkout

اعرض منتجات المجموعة في تجربة دفع موحّدة.

Customer Portal

اسمح للعملاء بترقية خططهم أو خفضها ضمن المجموعة نفسها.

Subscriptions

أدر الخطط المتكررة باستخدام التوزيع النسبي وتغييرات الخطة.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

أبرز المزايا

إنشاء مجموعة منتجات