شبكات البطاقات المدعومة
يقبل Dodo Payments الشبكات العالمية وعدة شبكات إقليمية.الشبكات العالمية
الشبكات الإقليمية
الإعداد
تستخدم البطاقات قيمتين فيallowed_payment_method_types:
تتيح هذه الجلسة الدفع بالبطاقات فقط:
المصادقة باستخدام 3D Secure
تطلب 3D Secure (3DS) من بنك حامل البطاقة تأكيد هوية حامل البطاقة، على سبيل المثال باستخدام رمز لمرة واحدة أو تحقق بيومتري أو موافقة في تطبيق البنك. يقلل ذلك من الاحتيال وعمليات رد المبالغ المدفوعة.متى يتم تشغيل 3DS
يطلب Dodo Payments إجراء 3DS عندما:- تتطلب شبكة البطاقات ذلك.
- تتطلب إحدى اللوائح الإقليمية ذلك، مثل PSD2 في أوروبا.
- يتم تصنيف المعاملة على أنها عالية المخاطر.
فرض 3DS
لطلب إجراء 3DS مع كل دفعة بالبطاقة لنشاطك التجاري، فعّل 3D Secure ضمن Settings → Pricing. لتجاوز هذا الإعداد لجلسة دفع واحدة، مرّرforce_3ds:
يقلل طلب إجراء 3DS مع كل معاملة من الاحتيال، لكنه قد يخفض معدل التحويل، لأن بعض العملاء يتركون عملية الدفع أثناء المصادقة.
التعامل مع فشل المصادقة
عندما تحتاج دفعة ما إلى مصادقة 3DS، تمر الدفعة بحالات وسيطة قبل نجاحها أو فشلها:
إذا لم تكتمل المصادقة، تفشل الدفعة باستخدام أحد رموز الرفض التالية:
AUTHENTICATION_FAILURE: تعذّرت مصادقة العميل.AUTHENTICATION_REQUIRED: المصادقة مطلوبة ولكن لم تُجرَ.AUTHENTICATION_TIMEOUT: لم يستجب العميل في الوقت المحدد.
أثناء الدفع مقابل التجديد
- أثناء الدفع (العميل حاضر): يظهر تحدي 3DS أثناء الدفع. إذا فشل، اطلب من العميل إعادة المحاولة أو استخدام بطاقة أخرى.
- عند تجديد الاشتراك (العميل غير حاضر): لا يمكن عرض تحدي 3DS في الوقت الفعلي. إذا تطلب التجديد المصادقة وفشل، ينتقل الاشتراك إلى
on_hold، أو إلىpast_dueأولًا إذا عيّنت فترة سماح. لاستعادته، اطلب من العميل العودة وتحديث طريقة الدفع. راجع التعامل مع فشل الدفع ومعالجة تعثر الاشتراكات.
طرق الدفع المحفوظة
يمكن للعملاء العائدين الدفع باستخدام بطاقة محفوظة من عملية دفع سابقة.Tokenized
لا يتم تخزين أرقام البطاقات الأصلية مطلقًا.
PCI Compliant
يتولى Dodo Payments معالجة الامتثال لمعيار PCI.
Customer-Scoped
تنتمي كل بطاقة محفوظة إلى عميل واحد.
تفعيل البطاقات المحفوظة
لعرض البطاقات المحفوظة لعميل عائد أثناء الدفع، مرّرshow_saved_payment_methods: true مع customer_id الموجود. الإعداد الافتراضي هو false.
عمليات الشراء بنقرة واحدة
لخصم قيمة من بطاقة محفوظة دون عرض صفحة الدفع، مرّرpayment_method_id الخاصة بها مع confirm: true وcustomer_id الموجود. تخصم الجلسة المبلغ من البطاقة مباشرةً ولا تعيد checkout_url، لذا استخدم webhooks لمعرفة نتيجة الدفع.
الاختبار
استخدم هذه البطاقات في وضع الاختبار. لمزيد من بيانات الاختبار، راجع عملية الاختبار.- Successful Payments
- Declined Payments
الأمان والامتثال
يطبّق Dodo Payments وسائل الحماية التالية على الدفعات بالبطاقات:أفضل الممارسات
Accept all major networks
Accept all major networks
لا تقيّد أنواع البطاقات إلا عند الحاجة. يتوقع العملاء أن تعمل البطاقة التي يفضلونها.
Display card logos
Display card logos
اعرض شعارات Visa وMastercard وAmex على موقعك لبناء الثقة.
Handle declines gracefully
Handle declines gracefully
اعرض رسائل خطأ واضحة. لا تعرض رموز الخطأ الأولية للعملاء.
Enable saved cards for returning customers
Enable saved cards for returning customers
تجعل طرق الدفع المحفوظة عمليات الشراء المتكررة أسرع للعملاء العائدين.
استكشاف الأخطاء وإصلاحها
Card declined
Card declined
الأسباب: رصيد غير كافٍ، أو بطاقة منتهية الصلاحية، أو CVV غير صحيح، أو حماية البنك من الاحتيال.الحل: اطلب من العميل التحقق من بياناته أو تجربة بطاقة أخرى. ابحث عن رمز خطأ الرفض والإجراء الموصى به في مرجع فشل المعاملات. راجع التعامل مع فشل الدفع لمعالجة حالات الرفض برمجيًا.
3DS authentication failed
3DS authentication failed
الأسباب: ترك العميل التحدي، أو كان نظام البنك غير متاح، أو انتهت مهلة التحدي.الحل: أعد المحاولة أو اطلب من العميل التواصل مع البنك. راجع التعامل مع فشل المصادقة لمعرفة حالات الدفع ورموز الرفض المعنية.
Card not supported
Card not supported
الأسباب: الشبكة الإقليمية غير مدعومة، أو البطاقة بطاقة مسبقة الدفع مقيّدة.الحل: اطلب من العميل تجربة بطاقة من شبكة رئيسية.
صفحات ذات صلة
Payment Methods Overview
جميع طرق الدفع المدعومة.
Upsells & Downsells
عمليات الشراء بنقرة واحدة باستخدام البطاقات المحفوظة.
Testing Process
بيانات اختبار لكل طريقة دفع.
Subscriptions
الفوترة المتكررة باستخدام البطاقات.