الانتقال إلى المحتوى الرئيسي
تمتلك الهند بنية تحتية دفع فريدة يهيمن عليها UPI (أكثر من 60% من المعاملات الرقمية) وبطاقات Rupay. تدعم Dodo Payments كلاهما مع الامتثال الكامل لتفويضات الاشتراك الخاصة بـ RBI.

لماذا تهم طرق الدفع في الهند

UPI Dominance

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

Low Transaction Costs

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

Subscription Support

على عكس معظم طرق الدفع البديلة، يدعم كل من UPI وRupay الدفعات المتكررة عبر تفويضات RBI.

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

الطريقةالنوعالاشتراكاتالحد الأدنى
UPI Collectرمز QR / VPAنعم*₹1
بطاقة Rupay الائتمانيةبطاقةنعم*₹1
بطاقة Rupay المدينةبطاقةنعم*₹1
*تتطلب الاشتراكات تفويضات متوافقة مع RBI مع قواعد معالجة خاصة.

التكوين

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

النوعالوصف
upi_collectUPI عبر رمز QR أو إدخال VPA
creditبطاقات الائتمان بما في ذلك Rupay
debitبطاقات الخصم بما في ذلك Rupay

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

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: [
    'upi_collect',
    'credit',
    'debit'
  ],
  billing_currency: 'INR',
  customer: {
    email: 'customer@example.in',
    name: 'Priya Sharma',
    phone_number: '+919876543210'
  },
  billing_address: {
    country: 'IN',
    zipcode: '560001'
  },
  return_url: 'https://example.com/success'
});

متطلبات UPI

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

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

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

كيف تعمل التفويضات وفق RBI

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

مبلغ الاشتراكنوع التفويضالحد
أقل من 15,000 روبيةتفويض عند الطلب15,000 روبية
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

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

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

// DON'T do this:
async function handleSubscriptionRenewal(subscription) {
  // ❌ Bad: Granting access immediately when charge is initiated
  grantPremiumAccess(subscription.customer_id);
}

// DO this:
async function handlePaymentWebhook(event) {
  if (event.type === 'payment.succeeded') {
    // ✅ Good: Only grant access after payment is confirmed
    grantPremiumAccess(event.data.customer_id);
  }
  
  if (event.type === 'payment.failed') {
    // Handle failed payment (mandate cancelled, insufficient funds)
    revokePremiumAccess(event.data.customer_id);
  }
}

أحداث الويب هوك لاشتراكات الهند

الحدثمتىالإجراء
subscription.createdتم تفويض التفويضتسجيل بدء الاشتراك
payment.succeeded~48 ساعة بعد تاريخ التحصيلمنح/استمرار الوصول
payment.failedفشل الخصمإخطار العميل، إيقاف الوصول
subscription.on_holdفشل الدفعمطالبة بتحديث وسيلة الدفع
subscription.activeتم إعادة التنشيط بعد الدفعاستعادة الوصول

الاختبار

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

الحالةمعرف UPI
نجاحsuccess@upi
فشلfailure@upi

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

العلامةالسيناريورقم البطاقةانتهاء الصلاحيةCVV
فيزانجاح457623891277145006/32123
فيزامرفوضة470613121121212306/32123
ماستركاردنجاح540916266938103406/32123
ماستركاردمرفوضة510510510510510006/32123

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

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

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

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

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