طرق الدفع

تدعم Dodo Payments مجموعة واسعة من طرق الدفع لمساعدتك في خدمة العملاء على مستوى العالم. تصبح جميع طرق الدفع المدرجة متاحة تلقائيًا بمجرد التحقق من حساب التاجر الخاص بك وتمكين وضع التشغيل المباشر.

التفعيل التلقائي: لا حاجة لتكوين إضافي من جانبك. جميع طرق الدفع مُعدة مسبقًا وتديرها Dodo Payments. يمكنك اختيار تقييد الطرق التي تظهر عند الدفع باستخدام تكوين API الموضح أدناه.

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

يوفر الجدول التالي مرجعًا سريعًا لجميع طرق الدفع المتاحة، وتوافرها الإقليمي، والقيود الرئيسية:

طريقة الدفع	الدول المدعومة	العملات المدعومة	تدعم الاشتراك
بطاقات الائتمان	عالمي	جميع العملات	نعم
بطاقات الخصم	عالمي	جميع العملات	نعم
Apple Pay	عالمي (باستثناء IN)	جميع العملات	نعم
Google Pay	عالمي (باستثناء IN)	جميع العملات	نعم
Amazon Pay	عالمي (باستثناء IN)	USD	لا
Cash App Pay	الولايات المتحدة	USD	لا
Afterpay (BNPL)	الولايات المتحدة، المملكة المتحدة	USD، GBP	لا
Klarna (BNPL)	الولايات المتحدة، أوروبا*	USD، EUR، GBP، DKK، NOK، SEK، CZK، RON، PLN، CHF	لا
PayPal	عالمي	EUR، GBP	لا
UPI	الهند	INR	نعم*
Rupay (بطاقات ائتمان/خصم)	الهند	INR	نعم*
Bancontact	بلجيكا	EUR	لا
EPS	النمسا	EUR	لا
iDEAL	هولندا	EUR	لا
Multibanco	البرتغال	EUR	لا

يجب أن تلبي كل معاملة المبلغ الأدنى المطلوب لكل عملة. بالنسبة لـ USD، الحد الأدنى هو 0.50 USD. تختلف الحدود الدنيا للعملات الأخرى حسب المنطقة. انظر العملات المدعومة والحدود الدنيا

تتطلب Klarna وAfterpay حدًا أدنى من مبلغ المعاملة قدره 50.01 USD (أو ما يعادلها في العملات المدعومة) لتكون مؤهلة عند الدفع. لن تكون المعاملات التي تقل عن هذا الحد مؤهلة لهذه الخيارات من BNPL.للحصول على تفاصيل حول الدول المدعومة من Klarna، يرجى الرجوع إلى قسم BNPL أدناه.

طرق الدفع الهندية: يتم دعم اشتراكات UPI وRupay مع تفويضات متوافقة مع RBI. راجع قسم الاشتراك مع تفويضات متوافقة مع RBI للحصول على تفاصيل مهمة حول حدود التفويض، وتأخيرات المعالجة.

تفاصيل طريقة الدفع

بطاقات الائتمان والخصم

تقبل Dodo Payments جميع شبكات بطاقات الائتمان والخصم الرئيسية على مستوى العالم. يمكنك قبول:

Visa – شبكة موثوقة ومقبولة على نطاق واسع عالميًا
Mastercard – شبكة قوية وآمنة ذات انتشار عالمي
American Express – فوائد مميزة وخدمة عملاء قوية
Discover – مكافآت تنافسية، وجود قوي في الولايات المتحدة
JCB – شبكة بطاقات آسيوية رائدة مع انتشار متزايد
UnionPay – مهيمنة في الصين وآسيا، مع قبول عالمي متزايد
Interac – شبكة الدفع الآمنة في كندا
Cartes Bancaires – مستخدمة على نطاق واسع في فرنسا
Diners Club – بطاقة دولية مميزة مع فوائد حصرية
البطاقات المحلية الكورية – دعم لشبكات البطاقات المحلية الكورية

المحافظ الرقمية

قدم للعملاء تجربة دفع سريعة وآمنة باستخدام المحافظ الرقمية:

Apple Pay – الدفع بسهولة على iOS وmacOS وwatchOS
Google Pay – مدفوعات آمنة على Android، والويب، وفي المتاجر
PayPal – مدفوعات عالمية باليورو والجنيه الإسترليني (غير متاحة للاشتراكات)
Cash App Pay – مدفوعات عبر الهاتف المحمول للعملاء في الولايات المتحدة (غير متاحة للاشتراكات)
Amazon Pay – استخدم بيانات اعتماد Amazon لعملية دفع بسيطة (غير متاحة للاشتراكات)

اشترِ الآن وادفع لاحقًا (BNPL)

زيادة التحويل من خلال تقديم خيارات تقسيط مرنة:

Klarna – تمكين المدفوعات المرنة مع خيارات Klarna: الدفع على 4 أقساط، الدفع خلال 30 يومًا، أو تمويل عملية الشراء. تتوفر Klarna في الولايات المتحدة و19 دولة أوروبية، بما في ذلك النمسا، بلجيكا، جمهورية التشيك، الدنمارك، فنلندا، فرنسا، ألمانيا، اليونان، أيرلندا، إيطاليا، هولندا، النرويج، بولندا، البرتغال، رومانيا، إسبانيا، السويد، سويسرا، والمملكة المتحدة. العملات المدعومة تشمل USD، EUR، GBP، DKK، NOK، SEK، CZK، RON، PLN، وCHF.
Afterpay – السماح للعملاء بتقسيم المشتريات إلى أربع مدفوعات بدون فوائد. تتوفر Afterpay في الولايات المتحدة والمملكة المتحدة، وتدعم المدفوعات بـ USD وGBP.

UPI وRupay (الهند)

قبول خيارات الدفع الهندية الرائدة:

UPI – يقوم العملاء بمسح رمز الاستجابة السريعة أو استخدام التطبيقات (Google Pay، PhonePe، Paytm، CRED) لإجراء تحويلات مصرفية فورية وغير تلامسية
بطاقات Rupay – مدفوعات ائتمانية وخصمية آمنة عبر شبكة البطاقات المحلية في الهند

طرق الدفع الأوروبية

قدم خيارات أوروبية محلية لزيادة التحويلات:

iDEAL (هولندا) – مدفوعات مصرفية عبر الإنترنت فورية هولندية
Bancontact (بلجيكا) – طريقة بطاقة الخصم الموثوقة في بلجيكا
Multibanco (البرتغال) – طريقة الدفع البرتغالية لتحويلات مصرفية ومدفوعات من أجهزة الصراف الآلي
EPS (النمسا) – مدفوعات مصرفية عبر الإنترنت مباشرة في النمسا

تكوين طرق الدفع

بينما تتوفر جميع طرق الدفع تلقائيًا بناءً على موقع العميل وعملته، يمكنك اختيار تقييد خيارات الدفع التي تظهر أثناء عملية الدفع باستخدام allowed_payment_method_types المعلمة.

متى يجب تكوين طرق الدفع

قد ترغب في تكوين طرق الدفع المسموح بها لـ:

التحكم في خيارات الدفع التي تظهر للعملاء بناءً على متطلبات عملك
تقييد طرق الدفع لأنواع معينة من المنتجات أو تدفقات المعاملات
الحفاظ على التناسق عبر تجارب الدفع المختلفة
تحسين تجربة الدفع لجمهورك المستهدف

التنفيذ

إضافة المعلمة إلى طلب API

قم بتضمين حقل allowed_payment_method_types في طلب إنشاء الدفع أو الاشتراك الخاص بك:

{
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay"
  ]
}

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

تحقق من أن طرق الدفع المحددة فقط تظهر عند الدفع.

اختبر توفر طرق الدفع مع مواقع العملاء المختلفة والعملات للتأكد من أن التكوين يعمل كما هو متوقع.

نقاط نهاية API

يدعم هذا التكوين نقاط النهاية التالية:

إنشاء جلسة دفع

إنشاء جلسات دفع مع طرق الدفع المسموح بها.

إنشاء دفع

مدفوعات لمرة واحدة مع الطرق المسموح بها.

إنشاء اشتراك

مدفوعات الاشتراك مع الطرق المتكررة.

أمثلة التنفيذ

دفع لمرة واحدة
اشتراك
تركيز إقليمي

{
  "amount": 1000,
  "currency": "usd",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay",
    "google_pay"
  ]
}

{
  "product_id": "prod_123",
  "customer_id": "cust_456",
  "allowed_payment_method_types": [
    "credit",
    "debit"
  ]
}

{
  "amount": 5000,
  "currency": "eur",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "ideal",
    "bancontact",
    "sepa"
  ]
}

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

السلوك الافتراضي

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

الاعتبارات الإقليمية

اعتبر سوقك المستهدف عند اختيار طرق الدفع. يمكن أن يؤدي تضمين خيارات محددة للمنطقة (مثل UPI للهند أو iDEAL لهولندا) إلى تحسين معدلات التحويل بشكل كبير في تلك الأسواق.

المراقبة والتحسين

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

اعتبارات مهمة

تعتمد توفر طرق الدفع على عوامل متعددة:

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

إضافة طريقة دفع إلى allowed_payment_method_types لا يضمن ظهورها - يجب أن تكون مؤهلة أيضًا بناءً على هذه العوامل.

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

طريقة الدفع لا تظهر عند الدفع

الأسباب المحتملة:

لم يتم تضمين طريقة الدفع في allowed_payment_method_types
طريقة الدفع غير مدعومة لموقع العميل
طريقة الدفع لا تدعم عملة المعاملة
للاشتراكات: طريقة الدفع لا تدعم المدفوعات المتكررة
مبلغ المعاملة أقل من الحد الأدنى (مثل طرق BNPL)

الحل: تحقق من تلبية جميع متطلبات الأهلية وتحقق من تكوين طلب API الخاص بك.

ظهور طرق دفع غير متوقعة

الأسباب المحتملة:

لم يتم تمرير معلمة allowed_payment_method_types بشكل صحيح
قد تكون هناك تكوينات متضاربة في لوحة تحكم التاجر الخاصة بك

الحل: راجع حمولة طلب API الخاصة بك وتأكد من أن المعلمة مُنسقة بشكل صحيح كمصفوفة من السلاسل النصية.

طريقة الدفع الإقليمية غير متاحة

الأسباب المحتملة:

لا يتطابق موقع العميل مع المنطقة المدعومة لطريقة الدفع
العملة غير مدعومة من قبل طريقة الدفع الإقليمية
قد لا يكون حساب التاجر الخاص بك مفعلًا لتلك الطريقة المحددة للدفع

الحل: تحقق من التوافق الإقليمي والعملة، واتصل بالدعم إذا كنت تعتقد أن الطريقة يجب أن تكون متاحة.

مشاكل اشتراك طريقة الدفع الهندية

فشل رسوم الاشتراك بعد الترقية/الخفض:

قد يتجاوز مبلغ الرسوم الجديد حد التفويض الحالي (حد ₹15,000)
قد يحتاج العميل إلى تحديث طريقة الدفع الخاصة به لإنشاء تفويض جديد

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

قد يكون العميل قد ألغى التفويض خلال نافذة المعالجة التي تستغرق 48 ساعة
قد يكون العميل قد فشل في تفويض رسوم ذات قيمة عالية (≥₹15,000)

الحل: راقب أحداث webhook لإلغاء التفويضات وفشل المدفوعات. نفذ منطق إعادة المحاولة أو اطلب من العملاء إعادة إنشاء طريقة الدفع الخاصة بهم.تأخير خصم المدفوعات:

سلوك طبيعي: الاشتراكات الهندية باستخدام بطاقات الائتمان وUPI لديها تأخير لمدة 48 ساعة بين بدء الرسوم والخصم الفعلي
قد يمتد هذا التأخير إلى 2-3 ساعات إضافية اعتمادًا على واجهات برمجة التطبيقات للبنك

الحل: هذا سلوك متوقع. لا تفعل المزايا أو الاعتمادات حتى يتم استلام تأكيد الدفع عبر webhooks.

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

متى يجب تحديث طرق الدفع:

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

بالنسبة للاشتراكات النشطة: تحديث طريقة الدفع للاشتراك النشط يقوم ببساطة بتحديث طريقة الدفع للتجديدات المستقبلية. لا يتم إنشاء رسوم فورية.بالنسبة للاشتراكات المعلقة: عندما يكون الاشتراك في حالة on_hold (بسبب فشل التجديد أو فشل رسوم تغيير الخطة)، سيؤدي تحديث طريقة الدفع إلى:

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

// Update payment method for active subscription
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

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

// For on_hold subscription - automatically creates charge
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  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
}

أحداث webhook:

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

مرجع API لتحديث طريقة الدفع

عرض الوثائق الكاملة لواجهة برمجة التطبيقات لتحديث طرق الدفع.

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

توسيع خيارات الدفع

نحن نضيف باستمرار طرق دفع جديدة إلى Dodo Payments. سيتم تحديث هذه الصفحة مع توفر المزيد من الخيارات. إذا كنت بحاجة إلى طريقة دفع معينة غير مدرجة هنا، يرجى الاتصال بنا على [email protected]، وسننظر في إضافتها إلى خارطة الطريق الخاصة بنا.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous