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

تتيح لك مجموعات المنتجات تجميع المنتجات ذات الصلة (مثل خطط 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	معطّل
فوترة الاستخدام عند الإيقاف المؤقت	تتم فوترة الاشتراك المتوقف مؤقتًا والقائم على الاستخدام مقابل الاستخدام المستحق في لحظة إيقافه مؤقتًا، بدلًا من ترحيل الاستخدام إلى الفاتورة الدورية التالية	مفعّل
منع إساءة استخدام الفترة التجريبية	يتم تحويل العملاء الذين سبق لهم استرداد فترة تجريبية إلى عملية شراء مدفوعة من دون فترة تجريبية، بدلًا من منحهم فترة تجريبية جديدة	معطّل

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

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

يتحكم إعداد “Allow Subscription Pause” في Customer Portal فقط — ويمكنك إيقاف الاشتراك مؤقتًا واستئنافه من لوحة التحكم أو API بغض النظر عن قيمة هذا الإعداد. ينطبق إعداد “Bill Usage at Pause” على الاشتراكات القائمة على الاستخدام فقط، ويتم تسجيله لكل دورة فوترة، لذا فإن تغييره في منتصف الدورة لا يغيّر طريقة تسوية الدورة الجارية. راجع إيقاف الاشتراكات مؤقتًا واستئنافها.

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

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

أبرز المزايا

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