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

لمرة واحدة

شحن مرة واحدة للوصول مدى الحياة أو تسليم واحد.

الاشتراكات

الفوترة وفق جدول زمني مع تجارب، وتوزيع، وإضافات.

اعتمادًا على الاستخدام

قياس الاستهلاك والفوترة بناءً على الاستخدام الفعلي.

​
إنشاء منتج

يمكنك إنشاء منتجات من لوحة التحكم أو عبر واجهة برمجة التطبيقات (API). اختر نموذج التسعير مسبقًا، لمرة واحدة، أو اشتراك، أو اعتمادًا على الاستخدام ثم قم بتكوين التفاصيل. لا يمكن تغيير نموذج التسعير لاحقًا؛ قم بإنشاء منتج جديد إذا كنت بحاجة إلى نموذج مختلف.
1

الاسم والوصف

قدم عنوانًا واضحًا ووصفًا موجزًا يركز على القيمة. يتم دعم Markdown في الأوصاف.
اجعل الجملة الأولى موجهة نحو العميل وتركز على النتائج؛ ستظهر بشكل بارز عند الدفع.
المنتجات
2

نموذج التسعير والسعر

اختر نموذج التسعير:
  • لمرة واحدة: سعر ثابت يُدفع مرة واحدة.
  • اشتراك: سعر متكرر مع فترة تجريبية اختيارية.
  • اعتمادًا على الاستخدام: سعر مستمد من الأحداث المقاسة.
ثم قم بتحديد التسعير:
  • السعر: المبلغ الأساسي والعملة.
  • خصم (%): خصم اختياري يظهر في الدفع والفواتير.
  • بالنسبة للاشتراكات، قم بتحديد تكرار كل (مثل، 1 شهر أو 1 سنة) وأيام التجربة إذا لزم الأمر.
تغيير السعر يؤثر فقط على المشتريات الجديدة. الاشتراكات الحالية تتبع قواعد تغيير الخطة.
3

وسائط المنتج

قم بتحميل الصور لعرض المنتج عند الدفع والفواتير. المدعوم PNG/JPG/WebP حتى 3 ميغابايت. يمكنك إعادة ترتيب أو استبدال في أي وقت.
4

الامتيازات الآلية (تحت الإعدادات المتقدمة)

قم بإرفاق التنفيذ الذي يتم تفعيله تلقائيًا بعد الدفع:
  • مفاتيح الترخيص: إصدار والتحقق من المفاتيح الفريدة
  • تنزيلات الملفات: منح الوصول الآمن للملفات
  • مخصص: تفعيل منطق الامتياز الخاص بك عبر webhooks
أضف أو أزل الفوائد مع تطور عرضك. يحصل المشتركون الحاليون على الوصول أو يفقدونه وفقًا لذلك.

​
المتغيرات وخيارات التسعير

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

​
إدارة المنتجات

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

​
إدارة لوحة التحكم

  • تحديث: تحرير الاسم، والوصف، والصور، والسعر، والحقول، والفوائد في أي وقت (نموذج التسعير غير قابل للتغيير).
  • أرشفة: إخفاء منتج من المشتريات الجديدة دون إزعاج العملاء الحاليين. يمكنك إلغاء الأرشفة لاحقًا.

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

تسمح لك التعليمات التالية بإنشاء، وتحديث، وإدارة، واسترجاع المنتجات، بما في ذلك تحميل الصور.
يمكن أن يكون المنتج عنصرًا لمرة واحدة أو خدمة قائمة على الاشتراك. لإنشاء منتج جديد، أرسل POST طلب إلى /products نقطة النهاية مع تفاصيل مثل الاسم، والوصف، والسعر، والعملة، وما إذا كان منتجًا متكررًا.بالنسبة للمنتجات المتكررة، قم بتعيين recurring: true وحدد billing_cycle (daily، weekly، monthly، yearly).

إنشاء واجهة برمجة التطبيقات للمنتج

عرض هيكل الطلب والاستجابة بالتفصيل في وثائق واجهة برمجة التطبيقات لإنشاء المنتج.
لتعديل منتج موجود، أرسل PATCH طلب إلى /products/{product_id} نقطة النهاية. يمكنك تحديث الخصائص مثل الاسم، والسعر، والوصف مع الحفاظ على التفاصيل الأخرى دون تغيير.تأكد من أن product_id في نقطة النهاية يتطابق مع منتج موجود.

تحديث واجهة برمجة التطبيقات للمنتج

عرض هيكل الطلب والاستجابة بالتفصيل في وثائق واجهة برمجة التطبيقات لتحديث المنتج.
يمكنك جلب قائمة بالمنتجات المخزنة في حسابك باستخدام GET طلب إلى /products نقطة النهاية. يتيح لك ذلك استرجاع تفاصيل المنتج، بما في ذلك المنتجات النشطة والأرشيفية.

استرجاع واجهة برمجة التطبيقات للمنتجات

عرض هيكل الطلب والاستجابة بالتفصيل في وثائق واجهة برمجة التطبيقات لاسترجاع المنتجات.
يمكنك ربط صورة بمنتج عن طريق تحميلها إلى AWS S3 باستخدام عنوان URL مسبق التوقيع المقدم من واجهة برمجة التطبيقات. أولاً، اطلب عنوان URL لتحميل الصورة من /products/{product_id}/images نقطة النهاية، ثم استخدم عنوان URL المقدم لتحميل الصورة خلال 60 ثانية.
ينتهي صلاحية عنوان URL المسبق التوقيع خلال 60 ثانية، لذا يجب تحميل الصورة خلال تلك الفترة الزمنية.
بمجرد استلام عنوان URL المسبق التوقيع من واجهة برمجة التطبيقات، قم بتحميل الصورة باستخدام PUT الطريقة. يضمن ذلك الوصول الآمن والمؤقت إلى AWS S3 لتحميل الصورة.المكتبات المدعومة لتحميل إلى S3:
  • Node.js: axios، node-fetch
  • Python: requests، boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
إذا كانت عملية التحميل ناجحة، ستعيد AWS S3 حالة 200 OK، مما يشير إلى أنه تم تخزين الصورة بنجاح.

تحميل واجهة برمجة التطبيقات لصورة المنتج

عرض هيكل الطلب والاستجابة بالتفصيل في وثائق واجهة برمجة التطبيقات لتحميل صورة المنتج.
إذا لم تعد ترغب في عرض أو استخدام منتج، يمكنك أرشفته باستخدام POST طلب إلى /products/{product_id}/archive نقطة النهاية. هذه العملية تخفي المنتج ولكن لا تحذفه بشكل دائم.

أرشفة واجهة برمجة التطبيقات للمنتج

عرض هيكل الطلب والاستجابة بالتفصيل في وثائق واجهة برمجة التطبيقات لأرشفة المنتج.
إذا كنت بحاجة إلى استعادة منتج مؤرشف، أرسل POST طلب إلى /products/{product_id}/unarchive نقطة النهاية. سيؤدي ذلك إلى إعادة تنشيط المنتج وجعله متاحًا للاستخدام مرة أخرى.

إلغاء أرشفة واجهة برمجة التطبيقات للمنتج

عرض هيكل الطلب والاستجابة بالتفصيل في وثائق واجهة برمجة التطبيقات لإلغاء أرشفة المنتج.

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

  • ابدأ بوضوح: منتجات منفصلة لكل خيار تسعير (شهري مقابل سنوي)
  • استخدم التجارب بحكمة: اقترن بالتجارب مع التوجيه لزيادة التفعيل
  • أتمتة التنفيذ: استخدم الفوائد وwebhooks للتسليم الفوري
  • تسمية بالبيانات الوصفية: تخزين معرفات النظام الخاصة بك للمصالحة
أنت جاهز لإنشاء منتجات وبدء البيع - لمرة واحدة، أو متكررة، أو حسب الاستخدام.