الاشتراكات - Dodo Payments Documentation

تتيح الاشتراكات لك بيع وصول مستمر مع تجديدات آلية. استخدم دورات فوترة مرنة، تجارب مجانية، تغييرات الخطة، والإضافات لتخصيص التسعير لكل عميل.

Upgrade & Downgrade

تحكم في تغييرات الخطة باستخدام النسبة وتحديثات الكمية.

On‑Demand Subscriptions

فوض تفويضًا الآن وادفع لاحقًا بمبالغ مخصصة.

Customer Portal

دع العملاء يديرون الخطط والفوترة والإلغاءات.

Subscription Webhooks

تفاعل مع أحداث دورة الحياة مثل الإنشاء والتجديد والإلغاء.

ما هي الاشتراكات؟

الاشتراكات هي منتجات متكررة يشتريها العملاء وفق جدول زمني. إنها مثالية لـ:

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

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

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

إنشاء الاشتراكات

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

إنشاء منتج الاشتراك

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

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

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

اختر فئة الضريبة الأكثر دقة لضمان جمع الضريبة الصحيح لكل منطقة.

التسعير

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

يؤثر تغيير التسعير على منتج نشط على المشتريات الجديدة. تتبع الاشتراكات الحالية إعدادات تغيير الخطة والنسبة الخاصة بك.

الإضافات مثالية للميزات القابلة للقياس مثل المقاعد أو التخزين. يمكنك التحكم في الكميات المسموح بها وسلوك النسبة عندما يغيرها العملاء.

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

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

استخدم البيانات الوصفية لتخزين المعرفات من نظامك (على سبيل المثال accountId) حتى تتمكن من تسوية الأحداث والفواتير لاحقًا.

تجارب الاشتراك

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

تكوين التجارب

قم بتعيين أيام الفترة التجريبية في قسم تسعير المنتج (استخدم 0 لتعطيلها). يمكنك تجاوز هذا عند إنشاء الاشتراكات:

// Via subscription creation
const subscription = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_monthly',
  trial_period_days: 14  // Overrides product's trial period
});

// Via checkout session
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_monthly', quantity: 1 }],
  subscription_data: { trial_period_days: 14 }
});

يجب أن تكون القيمة trial_period_days بين 0 و10,000 يوم.

اكتشاف حالة التجربة

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

لتحديد ما إذا كان الاشتراك في فترة تجربة، استرجع قائمة المدفوعات للاشتراك. إذا كان هناك دفعة واحدة فقط بمبلغ 0، فإن الاشتراك في فترة التجربة:

const subscription = await client.subscriptions.retrieve('sub_123');
const payments = await client.payments.list({
  subscription_id: subscription.subscription_id
});

// Check if subscription is in trial
const isInTrial = payments.items.length === 1 && 
                  payments.items[0].total_amount === 0;

تحديث فترة التجربة

مدد الفترة التجريبية بتحديث next_billing_date:

await client.subscriptions.update('sub_123', {
  next_billing_date: '2025-02-15T00:00:00Z'  // New trial end date
});

لا يمكنك تعيين next_billing_date إلى وقت ماضي. يجب أن يكون التاريخ في المستقبل.

تغييرات خطة الاشتراك

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

يمكنك تغيير خطط الاشتراك وتحديث تاريخ الفوترة التالي مباشرة من لوحة تحكم Dodo Payments. يوفر ذلك وسيلة سريعة لتعديل الاشتراكات لطلبات دعم العملاء أو الترقيات الترويجية أو انتقالات الخطط دون استدعاء واجهة برمجة التطبيقات.

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

Product Collections

جمع المنتجات ذات الصلة في مجموعات لتمكين مسارات ترقية/تخفيض سلسة في بوابة العملاء.

أوضاع النسبة

اختر كيف يتم محاسبة العملاء عند تغيير الخطط:

مقارنة سريعة لأنماط التقسيم الأربعة:

	`prorated_immediately`	`difference_immediately`	`full_immediately`	`do_not_bill`
ترقية	رسوم تناسبية للأيام المتبقية	يتم تحصيل فرق السعر الكامل	يتم تحصيل السعر الكامل للخطة الجديدة	لا رسوم — تبديل فوري
تخفيض	رصيد تناسبي للأيام المتبقية	فرق السعر الكامل كرصيد	لا رصيد، يتم التحصيل الكامل	لا رصيد — تبديل فوري
دورة الفوترة	تُعاد إلى اليوم	تُعاد إلى اليوم	تُعاد إلى اليوم	تبقى كما هي
الأفضل لـ	فوترة عادلة بناءً على الوقت	تغييرات الفئات البسيطة	إعادة ضبط دورة الفوترة	الهجرات المجانية أو التبديلات المجانية

`prorated_immediately`

تحصل على المبلغ المحسوب بناءً على الوقت المتبقي في دورة الفوترة الحالية. الأفضل للفوترة العادلة التي تأخذ في الحسبان الوقت غير المستخدم.

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

`difference_immediately`

تحصل على فرق السعر فورًا (عند الترقية) أو تضيف رصيدًا للتجديدات المستقبلية (عند التخفيض). الأفضل للسيناريوهات البسيطة للترقية/التخفيض.

// Upgrade: charges $50 (difference between $30 and $80)
// Downgrade: credits remaining value, auto-applied to renewals
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

يتم تطبيق الاعتمادات من التخفيضات التي تستخدم difference_immediately ضمن نطاق الاشتراك وتُطبق تلقائيًا على عمليات التجديد المستقبلية. وهي مختلفة عن الامتيازات الخاصة بـ Credit-Based Billing.

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

`full_immediately`

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

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_monthly',
  quantity: 1,
  proration_billing_mode: 'full_immediately'
});

`do_not_bill`

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

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new_plan',
  quantity: 1,
  proration_billing_mode: 'do_not_bill'
});

Example: Prorated upgrade calculation

سيناريو: عميل في الخطة الأساسية (

30/شهر) يترقى إلى الخطة الاحترافية (

80/شهر) في اليوم 16 من دورة 30 يومًا باستخدام prorated_immediately.

Unused credit from Basic = $30 × (15 remaining / 30 total) = $15.00
Prorated cost of Pro     = $80 × (15 remaining / 30 total) = $40.00
────────────────────────────────────────────────────────────────────
Immediate charge         = $40.00 − $15.00 = $25.00

التجديد التالي في 15 فبراير (16 يناير + 30 يومًا): $80.00/شهريًا.

لمزيد من أمثلة الحسابات التفصيلية والحالات المتقدمة، انظر دليل Upgrade & Downgrade Guide الكامل.

Example: Downgrade credit calculation

سيناريو: عميل في الخطة الاحترافية (

80/شهر) يخفض إلى الخطة المبدئية (

20/شهر) باستخدام difference_immediately.

Credit = Old plan − New plan = $80 − $20 = $60.00

$60 رصيد يُطبق تلقائيًا على تجديدات المستقبل:

التجديد 1: $20 −$ 20 (رصيد) = ** $0.00** ($ 40 رصيد متبقي)
التجديد 2: $20 −$ 20 (رصيد) = ** $0.00** ($ 20 رصيد متبقي)
التجديد 3: $20 −$ 20 (رصيد) = $0.00 (الرصيد مستهلك)
التجديد 4: $20.00 (السعر الكامل)

تعرف على المزيد حول كيفية إدارة الأرصدة في Upgrade & Downgrade Guide.

تغيير الخطط مع الإضافات

تعديل الإضافات عند تغيير الخطط. تُدرج الإضافات في حسابات التقسيم:

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [{ addon_id: 'addon_extra_seats', quantity: 2 }]  // Add add-ons
  // addons: []  // Empty array removes all existing add-ons
});

تؤدي تغييرات الخطة إلى تحميلات فورية. قد تؤدي الفشل في التحميل إلى نقل الاشتراك إلى حالة on_hold. تتبع التغييرات عبر أحداث ويب هوك subscription.plan_changed.

معاينة تغييرات الخطة

قبل الالتزام بتغيير الخطة، معاينة التحميل الدقيق والاشتراك الناتج:

const preview = await client.subscriptions.previewChangePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

// Show customer the charge before confirming
console.log('You will be charged:', preview.immediate_charge.summary);

Preview Change Plan API

معاينة تغييرات الخطة قبل الالتزام بها.

حالات الاشتراك

تمر الاشتراك بمجموعة محددة من الحالات طوال فترة حياته. يُعد هذا الجدول مرجعًا لكل حالة، وما يسببها، وكيف يمكنك استعادتها (أو إذا كان ممكناً استعادتها).

الحالة	ماذا تعني	قابلة للاسترداد؟	مسار الاسترداد / الخطوة التالية
`pending`	يجري إنشاء أو معالجة الاشتراك	—	انتظر `subscription.active` (أو `subscription.failed`)
`active`	الاشتراك نشط وسيتم تجديده تلقائيًا	—	لا تحتاج إلى اتخاذ أي إجراء
`on_hold`	فشل دفع التجديد (أو رسوم تغيير الخطة)؛ الاشتراك متوقف مؤقتاً	نعم	قم بتحديث وسيلة الدفع لإعادة التنشيط — تلقائيًا عبر إعادة المحاولة في الدفع والتوجيه، أو يدويًا عبر واجهة برمجة التطبيقات لتحديث وسيلة الدفع
`cancelled`	تم إلغاء الاشتراك ولن يتم تجديده	إعادة الشراء فقط	يجب على العميل البدء باشتراك جديد؛ يمكن لـ التوجيه تحفيز إعادة الشراء
`failed`	فشل إنشاء الاشتراك (فشلت التفويض أو الدفع الأولي)	لا — نهائية	يجب على العميل إنشاء اشتراك جديد بوسيلة دفع تعمل
`expired`	وصل الاشتراك إلى نهاية مدته	—	يجب على العميل بدء اشتراك جديد إذا أراد ذلك

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

آلة الحالة

حالة التعليق المؤقت

يدخل الاشتراك في حالة on_hold عندما:

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

عندما يكون الاشتراك في حالة on_hold، لن يتم تجديده تلقائيًا. يجب عليك تحديث وسيلة الدفع لإعادة تفعيل الاشتراك.

إعادة التفعيل من حالة التعليق المؤقت

لإعادة تفعيل اشتراك من حالة on_hold، قم بتحديث وسيلة الدفع. هذا تلقائيًا:

يُنشئ رسوم للديون المتبقية
يُصدر فاتورة
يُعالج الدفع باستخدام وسيلة الدفع الجديدة
يُعيد تفعيل الاشتراك إلى حالة active عند نجاح الدفع

// Reactivate subscription from on_hold
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  payment_method: {
    type: 'new',
    return_url: 'https://example.com/return'
  }
});

// For on_hold subscriptions, a charge is automatically created
if (response.payment_id) {
  console.log('Charge created:', response.payment_id);
  // Redirect customer to response.payment_link to complete payment
  // Monitor webhooks for payment.succeeded and subscription.active
}

بعد تحديث وسيلة الدفع بنجاح لاشتراك on_hold، ستتلقى payment.succeeded يليه أحداث الويب هوك subscription.active.

أحداث الويب هوك حسب الانتقال

كل انتقال يُصدر ويب هوك حتى تتمكن من تحريك منطق الحقوق دون الاستطلاع:

الانتقال	الحدث
تنشيط الاشتراك	`subscription.active`
النجاح في التجديد	`subscription.renewed`
فشل التجديد → متوقف مؤقتاً	`subscription.on_hold`
فشل في الإنشاء	`subscription.failed`
ترقية/خفض الخطة	`subscription.plan_changed`
إلغاء	`subscription.cancelled`
انتهاء المدة	`subscription.expired`
أي تغييرات في الحقول	`subscription.updated`

Subscription Webhook Payloads

عرض مخطط الحمولة الكامل لأحداث دورة حياة الاشتراك.

إدارة API

Create subscriptions

استخدم POST /subscriptions لإنشاء الاشتراكات برمجياً من المنتجات، مع التجارب الاختيارية والإضافات.

API Reference

عرض API لإنشاء الاشتراك.

Update subscriptions

استخدم PATCH /subscriptions/{id} لتحديث الكميات، الإلغاء عند تاريخ الفوترة التالي، أو تعديل البيانات الوصفية.

API Reference

تعلم كيفية تحديث تفاصيل الاشتراك.

Change plans (proration)

قم بتغيير المنتج النشط والكميات مع ضوابط التناسب.

API Reference

مراجعة خيارات تغيير الخطة.

On‑demand charges

بالنسبة للاشتراكات عند الطلب، فرض مبالغ معينة عند الطلب.

API Reference

فرض تكاليف اشتراك عند الطلب.

List and retrieve

استخدم GET /subscriptions لقائمة جميع الاشتراكات و GET /subscriptions/{id} لاسترداد واحدة.

API Reference

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

Usage history

احصل على الاستخدام المسجل لنماذج التسعير المقاسة أو المختلطة.

API Reference

شاهد واجهة برمجة التطبيقات لتاريخ الاستخدام.

Update payment method

قم بتحديث وسيلة الدفع للاشتراك. بالنسبة للاشتراكات النشطة، يتم تحديث وسيلة الدفع للتجديدات المستقبلية. بالنسبة للاشتراكات في حالة on_hold، يتم إعادة تفعيل الاشتراك عن طريق إنشاء رسوم للديون المتبقية.عند توليد رابط وسيلة دفع جديدة (نوع الطلب New)، يمكنك تمرير allowed_payment_method_types لتقييد وسائل الدفع التي يراها العميل في تلك الصفحة. لن يرى العملاء وسيلة غير موجودة في القائمة، على الرغم من أن تضمين وسيلة لا يضمن ظهورها (لا يزال التوفر يعتمد على عوامل مثل موقع العميل وإعدادات عملك).

API Reference

تعلم كيفية تحديث وسائل الدفع وإعادة تفعيل الاشتراكات.

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

SaaS وAPIs: وصول شبه منظم مع إضافات للمقاعد أو الاستخدام
المحتوى والوسائط: وصول شهري مع تجارب تعريفية
خطط الدعم B2B: عقود سنوية مع إضافات دعم مميزة
الأدوات والمكونات الإضافية: مفاتيح ترخيص وإصدارات مرقمة

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

جلسات الإتمام (الاشتراكات)

عند إنشاء جلسات الإتمام، تضمّن منتج الاشتراك الخاص بك وملحقات اختيارية:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_subscription',
      quantity: 1
    }
  ]
});

تغييرات الخطط مع التناسبية

ترقية أو تخفيض اشتراك وتحكم في سلوك التناسبية:

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

الإلغاء في تاريخ الفوترة التالي

جدولة إلغاء يتخذ أثره في نهاية فترة الفوترة الحالية:

await client.subscriptions.update('sub_123', {
  cancel_at_next_billing_date: true
});

تمديد فترة الاشتراك

قم بتمديد فترة الاشتراك بتمرير subscription_period_count جديدة و subscription_period_interval إلى PATCH /subscriptions/{id}. يتم إعادة حساب انتهاء الاشتراك من العدد والفترة الزمنية الجديدة — على سبيل المثال، لمنح العميل وقتًا إضافيًا على خطته الحالية:

await client.subscriptions.update('sub_123', {
  subscription_period_count: 5,
  subscription_period_interval: 'Month'
});

يمكن فقط زيادة فترة الاشتراك، ولا يمكن تقصيرها أبدًا.

الاشتراكات عند الطلب

قم بإنشاء اشتراك عند الطلب وفرض رسوم لاحقة عند الحاجة:

const onDemand = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_on_demand',
  on_demand: { mandate_only: true }
});

await client.subscriptions.charge(onDemand.id, {
  product_price: 4900,
  product_currency: 'USD',
  product_description: 'Extra usage for September'
});

تحديث طريقة الدفع للاشتراك النشط

قم بتحديث طريقة الدفع للاشتراك النشط:

// Update with new payment method
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  payment_method: {
    type: 'new',
    return_url: 'https://example.com/return'
  }
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  payment_method: {
    type: 'existing',
    payment_method_id: 'pm_abc123'
  }
});

إعادة تنشيط الاشتراك من on_hold

إعادة تنشيط اشتراك وُضع في الانتظار بسبب فشل الدفع:

// Update payment method - automatically creates charge for remaining dues
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  payment_method: {
    type: 'new',
    return_url: 'https://example.com/return'
  }
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

الاشتراكات مع الالتزامات المتوافقة مع RBI

تعمل اشتراكات UPI وبطاقات الهند تحت لوائح RBI (بنك الاحتياطي الهندي) مع متطلبات التزام معينة:

حدود الالتزام

يعتمد نوع الالتزام والمبلغ على الشحن الدوري لاشتراكك:

الرسوم أقل من حد الالتزام (افتراضيًا ₹15,000): نقوم بإنشاء التزام عند الطلب لمبلغ الحد الأدنى. يتم تحصيل مبلغ الاشتراك بشكل دوري وفقًا لتكرار الاشتراك حتى حد الالتزام.
- الرسوم التي تساوي أو تزيد عن حد الالتزام: نقوم بإنشاء التزام اشتراك (أو التزام عند الطلب) لمبلغ الاشتراك الدقيق.

يمكن تكوين حد الالتزام لكل تاجر أو لكل طلب عبر mandate_min_amount_inr_paise (INR paise). المبلغ المسجل لدى البنك هو max(mandate_floor, billing_amount) — لذا فإن الحد الأدنى يصبح عمليًا سقف التفويض المباشر للعملاء عند انخفاض الفواتير. للحصول على معلومات تفصيلية حول الالتزامات المتوافقة مع RBI والحد الأدنى القابل للتكوين لطرق الدفع الهندية، انظر صفحة طرق الدفع الهندية.

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

مهم: عند ترقية أو تخفيض الاشتراكات، يجب مراعاة حدود الالتزام بعناية:

إذا أدت الترقية/التخفيض إلى مبلغ شحن يتجاوز ₹15,000 ويتجاوز حد الدفع الفوري القائم، فقد يفشل رسوم المعاملة.
- في مثل هذه الحالات، قد يحتاج العميل إلى تحديث طريقة الدفع الخاصة به أو تغيير الاشتراك مرة أخرى لإنشاء التزام جديد بالحد الصحيح.

التفويض للرسوم العالية القيمة

لرسوم الاشتراك البالغة ₹15,000 أو أكثر:

سيطلب البنك من العميل تفويض المعاملة.
- إذا فشل العميل في تفويض المعاملة، ستفشل المعاملة وسيتم وضع الاشتراك في الانتظار.

تأخير معالجة لمدة 48 ساعة

جدول المعالجة: تتبع الرسوم الدورية على البطاقات الهندية واشتراكات UPI نمط معالجة فريد:

يتم بدء الرسوم في التاريخ المحدد وفقًا لتكرار الاشتراك.
- يحدث الخصم الفعلي من حساب العميل بعد 48 ساعة من بدء الدفع.
- قد يمتد هذا النطاق الزمني البالغ 48 ساعة إلى 2-3 ساعات إضافية اعتمادًا على استجابات واجهة برمجة التطبيقات للبنك.

نافذة إلغاء الالتزام

خلال نافذة المعالجة لمدة 48 ساعة:

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

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

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

مراقبة الويب هوكس للاشتراك لتتبع تغييرات حالة الدفع ومعالجة حالات الحافة حيث يتم إلغاء الالتزامات خلال النطاق الزمني البالغ 48 ساعة.

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

ابدأ بتصنيفات واضحة: خطتان إلى ثلاث خطط مع فروق واضحة
وضح التسعير: عرض الإجماليات والتناسب والتجديد التالي
استخدام التجارب بإيجابية: التحويل مع الإعداد وليس فقط الوقت
الاستفادة من الإضافات: الحفاظ على الخطط الأساسية بسيطة وزيادة المبيعات الإضافية
اختبار التغييرات: التحقق من صحة تغييرات الخطط والتناسب في وضع الاختبار

تعد الاشتراكات أساسًا مرنًا للإيرادات المتكررة. ابدأ ببساطة، اختبر بدقة، وكرر بناءً على مؤشرات التبني، والتغيير، والتوسع.

آخر تعديل في ٩ يوليو ٢٠٢٦

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

Upgrade & Downgrade

On‑Demand Subscriptions

Customer Portal

Subscription Webhooks

​ما هي الاشتراكات؟

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

​إنشاء الاشتراكات

​إنشاء منتج الاشتراك

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

​التسعير

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

​تجارب الاشتراك

​تكوين التجارب

​اكتشاف حالة التجربة

​تحديث فترة التجربة

​تغييرات خطة الاشتراك

Product Collections

​أوضاع النسبة

​prorated_immediately

​difference_immediately

​full_immediately

​do_not_bill

​تغيير الخطط مع الإضافات

​معاينة تغييرات الخطة

Preview Change Plan API

​حالات الاشتراك

​آلة الحالة

​حالة التعليق المؤقت

​إعادة التفعيل من حالة التعليق المؤقت

​أحداث الويب هوك حسب الانتقال

Subscription Webhook Payloads

​إدارة API

API Reference

API Reference

API Reference

API Reference

API Reference

API Reference

API Reference

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

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

​جلسات الإتمام (الاشتراكات)

​تغييرات الخطط مع التناسبية

​الإلغاء في تاريخ الفوترة التالي

​تمديد فترة الاشتراك

​الاشتراكات عند الطلب

​تحديث طريقة الدفع للاشتراك النشط

​إعادة تنشيط الاشتراك من on_hold

​الاشتراكات مع الالتزامات المتوافقة مع RBI

​حدود الالتزام

​اعتبارات الترقية والتخفيض

​التفويض للرسوم العالية القيمة

​تأخير معالجة لمدة 48 ساعة

​نافذة إلغاء الالتزام

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

ما هي الاشتراكات؟

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

إنشاء الاشتراكات

إنشاء منتج الاشتراك

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

التسعير

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

تجارب الاشتراك

تكوين التجارب

اكتشاف حالة التجربة

تحديث فترة التجربة

تغييرات خطة الاشتراك

أوضاع النسبة

`prorated_immediately`

`difference_immediately`

`full_immediately`

`do_not_bill`

تغيير الخطط مع الإضافات

معاينة تغييرات الخطة

حالات الاشتراك

آلة الحالة

حالة التعليق المؤقت

إعادة التفعيل من حالة التعليق المؤقت

أحداث الويب هوك حسب الانتقال

إدارة API

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

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

جلسات الإتمام (الاشتراكات)

تغييرات الخطط مع التناسبية

الإلغاء في تاريخ الفوترة التالي

تمديد فترة الاشتراك

الاشتراكات عند الطلب

تحديث طريقة الدفع للاشتراك النشط

إعادة تنشيط الاشتراك من on_hold

الاشتراكات مع الالتزامات المتوافقة مع RBI

حدود الالتزام

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

التفويض للرسوم العالية القيمة

تأخير معالجة لمدة 48 ساعة

نافذة إلغاء الالتزام

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