أهمية طرق الدفع في الهند
UPI Dominance
تُعالج UPI أكثر من 10 مليارات معاملة شهريًا. ولا يمتلك العديد من العملاء الهنود بطاقات دولية.
Low Transaction Costs
تفرض UPI رسوم معاملات شبه معدومة. وهي ممتازة للمعاملات ذات الحجم الكبير والقيمة المنخفضة.
Subscription Support
على عكس معظم طرق الدفع البديلة، تدعم UPI وجميع البطاقات المُصدرة في الهند (Visa وMastercard وRupay وغيرها) المدفوعات المتكررة عبر تفويضات RBI.
الطرق المدعومة
*تتطلب الاشتراكات تفويضات متوافقة مع RBI مع قواعد معالجة خاصة. تنطبق مهلة المعالجة البالغة 48 ساعة على جميع البطاقات المُصدرة في الهند وUPI.
الإعداد
أنواع طرق API
مثال: صفحة دفع مخصصة للهند
متطلبات UPI
لكي تظهر UPI عند الدفع:- يجب أن تكون دولة الفوترة هي الهند (
IN) - يجب أن تكون العملة هي INR
- بالنسبة إلى التجار من خارج الهند: يجب تمكين Adaptive Currency
الاشتراكات مع تفويضات 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، على ثلاثة مستويات:
أولوية تحديد القيمة: التجاوز لكل طلب ← إعداد التاجر ← القيمة الافتراضية للنظام.
يسمح لك تعيين حد أدنى أعلى بدعم رسوم فردية أكبر لاحقًا (مثل ترقيات الخطط أو الرسوم الإضافية المستندة إلى الاستخدام) دون إجبار العملاء على إعادة التفويض. ويجعل تعيين حد أدنى أقل تفويض العميل أقرب إلى مبلغ الفوترة الفعلي، لكنه يحد من هامش الرسوم المتغيرة المستقبلية.
مهلة المعالجة البالغة 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 بعد الخصم الفعلي، وليس عند بدء العملية.التعامل مع نافذة الـ48 ساعة
أحداث Webhook للاشتراكات الهندية
الاختبار
معرّفات اختبار UPI
أرقام اختبار البطاقات الهندية
أفضل الممارسات
Plan for the 48-hour delay
Plan for the 48-hour delay
صمّم تطبيقك للتعامل مع الفجوة بين بدء الخصم والدفع الفعلي. ضع في اعتبارك:
- فترات سماح للوصول إلى الاشتراك
- التواصل الواضح مع العملاء بشأن مدة المعالجة
- تنفيذ يعتمد على webhooks، وليس على التواريخ
Handle mandate cancellations
Handle mandate cancellations
يمكن للعملاء إلغاء التفويضات عبر تطبيقاتهم المصرفية في أي وقت. راقب webhooks
subscription.on_hold واطلب من العملاء إعادة الاشتراك أو تحديث طرق الدفع.Set appropriate mandate amounts
Set appropriate mandate amounts
بالنسبة إلى التسعير المتغير (مثل التسعير المستند إلى الاستخدام)، ضع في اعتبارك ما إذا كان تفويض عند الطلب بقيمة Rs 15,000 كافيًا. إذا تجاوزت الرسوم هذا المبلغ، فسيتعين على العملاء إعادة التفويض.
Offer UPI prominently
Offer UPI prominently
بالنسبة إلى العملاء الهنود، ينبغي أن تكون UPI خيار الدفع الأساسي. يفضلها العديد من المستخدمين على البطاقات بسبب familiarity وسهولة الاستخدام الأكبر.
استكشاف الأخطاء وإصلاحها
UPI not appearing at checkout
UPI not appearing at checkout
تحقق من:
- هل تم تعيين دولة الفوترة إلى
IN؟ - هل تم تعيين العملة إلى
INR؟ - إذا كان التاجر من خارج الهند: هل تم تمكين Adaptive Currency؟
- هل تم تضمين
upi_collectفيallowed_payment_method_types؟
country: "IN" وbilling_currency: "INR".Subscription charge failed after upgrade
Subscription charge failed after upgrade
السبب: يتجاوز مبلغ الخصم الجديد حد التفويض الحالي (عتبة Rs 15,000).الحل: يجب على العميل تحديث طريقة الدفع لإنشاء تفويض جديد بالحد الصحيح.
Subscription on hold but customer claims they didn't cancel
Subscription on hold but customer claims they didn't cancel
السبب: ربما ألغى العميل التفويض خلال نافذة الـ48 ساعة، أو رفض البنك عملية الخصم.الحل: يحتاج العميل إلى إعادة تفويض التفويض أو تحديث طريقة الدفع.
Payment deduction delayed beyond 48 hours
Payment deduction delayed beyond 48 hours
السبب: قد تؤدي تأخيرات Bank API إلى تمديد المعالجة لمدة ساعتين أو ثلاث ساعات إضافية.الحل: هذا متوقع. صمّم نظامك للتعامل مع تأخيرات متغيرة تصل إجمالًا إلى نحو 51 ساعة.
Mandate cancelled but subscription still active
Mandate cancelled but subscription still active
السبب: حالة خاصة في لوائح RBI — لا يؤدي إلغاء التفويض أثناء نافذة المعالجة إلى إلغاء الاشتراك فورًا.الحل: ستفشل عملية الخصم التالية، وسينتقل الاشتراك إلى
on_hold. راقب webhooks بحثًا عن payment.failed.الصفحات ذات الصلة
Payment Methods Overview
اطّلع على جميع طرق الدفع المدعومة.
Subscriptions
اطّلع على وثائق الاشتراكات الكاملة، بما في ذلك تفويضات RBI.
Webhooks
التعامل مع webhooks لأحداث الدفع.
Testing Process
جميع بيانات الاختبار، بما في ذلك معرّفات UPI والبطاقات الهندية.