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

ما هي المدفوعات لمرة واحدة؟

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

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

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

إنشاء منتجات لمرة واحدة

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

تكوين المنتج

قم بتكوين الحقول في لوحة التحكم لتعريف كيفية ظهور منتجك وبيعه.

تفاصيل المنتج

  • اسم المنتج (مطلوب): الاسم المعروض في الدفع والفواتير
  • وصف المنتج (مطلوب): بيان قيمة واضح يراه العملاء قبل الدفع
  • صورة المنتج (مطلوبة): PNG/JPG/WebP حتى 3 ميغابايت
  • العلامة التجارية: ربط المنتج بعلامة تجارية معينة للتصميم والبريد الإلكتروني
  • فئة الضريبة (مطلوبة): اختر الفئة الصحيحة لتحديد قواعد الضريبة
اختر فئة الضريبة الأكثر دقة لضمان جمع الضرائب بشكل صحيح حسب المنطقة.

التسعير

  • نوع التسعير: اختر دفعة واحدة
  • السعر (مطلوب): رسوم ثابتة مع العملة
  • الخصم المطبق (%): نسبة الخصم الاختيارية المعروضة في الدفع والفواتير
تغيير تسعير المنتج يؤثر فقط على المشتريات الجديدة. العملاء الحاليون لن يتأثروا.

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

  • أسعار شاملة الضرائب: عرض الأسعار شاملة الضرائب المطبقة
  • إنشاء مفاتيح الترخيص: إصدار مفتاح فريد بعد الشراء. انظر مفاتيح الترخيص
  • تسليم المنتج الرقمي: تسليم الملفات أو المحتوى تلقائيًا. انظر تسليم المنتج الرقمي
  • البيانات الوصفية: إرفاق أزواج مفتاح-قيمة مخصصة للتصنيف الداخلي أو التكاملات. انظر البيانات الوصفية
استخدم البيانات الوصفية لتخزين المعرفات من نظامك (مثل orderId) لمصالحة الأحداث والإيصالات لاحقًا.

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

استخدم POST /checkout-sessions/create لإنشاء رسوم لمرة واحدة من المنتجات.

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

عرض واجهة برمجة التطبيقات لإنشاء المدفوعات.
استخدم POST /refunds لإنشاء استردادات كاملة أو جزئية.

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

تعلم كيفية استرداد دفعة.
استخدم GET /payments لقائمة المدفوعات و GET /payments/{payment_id} لاسترجاع واحدة. استرجع عناصر السطر باستخدام GET /payments/{payment_id}/line-items.

قائمة المدفوعات

تصفح واجهة برمجة التطبيقات للقائمة.

الحصول على تفاصيل الدفع

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

استرجاع عناصر السطر

فحص العناصر المشتراة لدفع معين.
التفاعل مع أحداث مثل payment.succeeded أو payment.failed في الخلفية الخاصة بك.

دليل Webhook

التعامل مع أحداث دورة حياة الدفع.

حالات الاستخدام الشائعة

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

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

جلسات الدفع (دفعة واحدة)

إنشاء جلسة دفع مع منتج لمرة واحدة في السلة:
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_one_time', quantity: 1 }
  ]
});

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

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