Skip to main content
تتمتع الهند ببنية تحتية فريدة للدفع، تهيمن عليها UPI (أكثر من 60% من المعاملات الرقمية) والبطاقات المُصدرة في الهند (Visa وMastercard وRupay وغيرها). Dodo Payments تدعم كل هذه الخيارات مع الامتثال الكامل لمتطلبات RBI الخاصة بتفويضات الاشتراك.

أهمية طرق الدفع في الهند

UPI Dominance

تُعالج UPI أكثر من 10 مليارات معاملة شهريًا. ولا يمتلك العديد من العملاء الهنود بطاقات دولية.

Low Transaction Costs

تفرض UPI رسوم معاملات شبه معدومة. وهي ممتازة للمعاملات ذات الحجم الكبير والقيمة المنخفضة.

Subscription Support

على عكس معظم طرق الدفع البديلة، تدعم UPI وجميع البطاقات المُصدرة في الهند (Visa وMastercard وRupay وغيرها) المدفوعات المتكررة عبر تفويضات RBI.

الطرق المدعومة

*تتطلب الاشتراكات تفويضات متوافقة مع RBI مع قواعد معالجة خاصة. تنطبق مهلة المعالجة البالغة 48 ساعة على جميع البطاقات المُصدرة في الهند وUPI.

الإعداد

أنواع طرق API

مثال: صفحة دفع مخصصة للهند

متطلبات UPI

لكي تظهر UPI عند الدفع:
  1. يجب أن تكون دولة الفوترة هي الهند (IN)
  2. يجب أن تكون العملة هي INR
  3. بالنسبة إلى التجار من خارج الهند: يجب تمكين Adaptive Currency
إذا كنت تاجرًا من خارج الهند ولم يتم تمكين Adaptive Currency، فلن تكون UPI متاحة لعملائك.

الاشتراكات مع تفويضات RBI

تعمل اشتراكات طرق الدفع الهندية بموجب لوائح RBI (Reserve Bank of India) مع متطلبات فريدة.

آلية عمل تفويضات RBI

أنواع التفويضات

المبلغ المسجل لدى بنك العميل هو max(mandate_floor, billing_amount). لذلك، يمثل الحد الأدنى فعليًا سقف التفويض الذي يراه العميل عندما تكون الفوترة أقل من هذا الحد. مهم عند تغيير الخطة: إذا أدت الترقية إلى رسم يتجاوز حد التفويض الحالي، فستفشل العملية وسيتعين على العميل إعادة التفويض.

حد التفويض الأدنى القابل للتهيئة

يمكن تهيئة حد التفويض الأدنى للتفويضات الإلكترونية بعملة INR عبر الحقل mandate_min_amount_inr_paise (بوحدة paise الهندية — 1 INR = 100 paise). يمكنك تجاوز القيمة الافتراضية للنظام، وهي ₹15,000، على ثلاثة مستويات: أولوية تحديد القيمة: التجاوز لكل طلب ← إعداد التاجر ← القيمة الافتراضية للنظام.
يسمح لك تعيين حد أدنى أعلى بدعم رسوم فردية أكبر لاحقًا (مثل ترقيات الخطط أو الرسوم الإضافية المستندة إلى الاستخدام) دون إجبار العملاء على إعادة التفويض. ويجعل تعيين حد أدنى أقل تفويض العميل أقرب إلى مبلغ الفوترة الفعلي، لكنه يحد من هامش الرسوم المتغيرة المستقبلية.
يؤثر هذا الإعداد فقط في التفويضات الإلكترونية المسجلة للبطاقات المُصدرة في الهند (Visa وMastercard وRuPay) ضمن الاشتراكات بعملة INR. وتتبع اشتراكات UPI تدفق AutoPay الخاص بها ولا تتأثر.

مهلة المعالجة البالغة 48 ساعة

هذا هو الاختلاف الأهم عن مدفوعات البطاقات الدولية:
1

Charge Initiated (Day 0)

في تاريخ التجديد المجدول، يبدأ Dodo عملية الخصم مع البنك.
2

Pre-Debit Notification

يتلقى العميل إشعارًا من بنكه بشأن الخصم القادم.
3

48-Hour Window

يمكن للعميل إلغاء التفويض خلال هذه الفترة عبر تطبيقه المصرفي.
4

Debit Completed (~48-51 hours)

بعد 48 ساعة (بالإضافة إلى ما يصل إلى 3 ساعات إضافية لمعالجة البنك)، تُخصم الأموال.
5

Webhook Sent

يُرسل webhook ‏payment.succeeded بعد الخصم الفعلي، وليس عند بدء العملية.
لا تمنح المزايا عند بدء الخصم. انتظر webhook ‏payment.succeeded، الذي يصل بعد نحو 48 إلى 51 ساعة من تاريخ الخصم المجدول.

التعامل مع نافذة الـ48 ساعة

أحداث Webhook للاشتراكات الهندية

الاختبار

معرّفات اختبار UPI

أرقام اختبار البطاقات الهندية

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

صمّم تطبيقك للتعامل مع الفجوة بين بدء الخصم والدفع الفعلي. ضع في اعتبارك:
  • فترات سماح للوصول إلى الاشتراك
  • التواصل الواضح مع العملاء بشأن مدة المعالجة
  • تنفيذ يعتمد على webhooks، وليس على التواريخ
يمكن للعملاء إلغاء التفويضات عبر تطبيقاتهم المصرفية في أي وقت. راقب webhooks ‏subscription.on_hold واطلب من العملاء إعادة الاشتراك أو تحديث طرق الدفع.
بالنسبة إلى التسعير المتغير (مثل التسعير المستند إلى الاستخدام)، ضع في اعتبارك ما إذا كان تفويض عند الطلب بقيمة Rs 15,000 كافيًا. إذا تجاوزت الرسوم هذا المبلغ، فسيتعين على العملاء إعادة التفويض.
بالنسبة إلى العملاء الهنود، ينبغي أن تكون UPI خيار الدفع الأساسي. يفضلها العديد من المستخدمين على البطاقات بسبب familiarity وسهولة الاستخدام الأكبر.

استكشاف الأخطاء وإصلاحها

تحقق من:
  1. هل تم تعيين دولة الفوترة إلى IN؟
  2. هل تم تعيين العملة إلى INR؟
  3. إذا كان التاجر من خارج الهند: هل تم تمكين Adaptive Currency؟
  4. هل تم تضمين upi_collect في allowed_payment_method_types؟
الحل: تحقق من أن عنوان الفوترة يتضمن country: "IN" وbilling_currency: "INR".
السبب: يتجاوز مبلغ الخصم الجديد حد التفويض الحالي (عتبة Rs 15,000).الحل: يجب على العميل تحديث طريقة الدفع لإنشاء تفويض جديد بالحد الصحيح.
السبب: ربما ألغى العميل التفويض خلال نافذة الـ48 ساعة، أو رفض البنك عملية الخصم.الحل: يحتاج العميل إلى إعادة تفويض التفويض أو تحديث طريقة الدفع.
السبب: قد تؤدي تأخيرات Bank API إلى تمديد المعالجة لمدة ساعتين أو ثلاث ساعات إضافية.الحل: هذا متوقع. صمّم نظامك للتعامل مع تأخيرات متغيرة تصل إجمالًا إلى نحو 51 ساعة.
السبب: حالة خاصة في لوائح RBI — لا يؤدي إلغاء التفويض أثناء نافذة المعالجة إلى إلغاء الاشتراك فورًا.الحل: ستفشل عملية الخصم التالية، وسينتقل الاشتراك إلى on_hold. راقب webhooks بحثًا عن payment.failed.

الصفحات ذات الصلة

Payment Methods Overview

اطّلع على جميع طرق الدفع المدعومة.

Subscriptions

اطّلع على وثائق الاشتراكات الكاملة، بما في ذلك تفويضات RBI.

Webhooks

التعامل مع webhooks لأحداث الدفع.

Testing Process

جميع بيانات الاختبار، بما في ذلك معرّفات UPI والبطاقات الهندية.
آخر تعديل في ٦ أغسطس ٢٠٢٦