Skip to main content
تتوفر البطاقات في كل صفحة دفع عبر Dodo Payments، وفي كل بلد وعملة مدعومين. يقبل Dodo Payments شبكات البطاقات الرئيسية، ويستبدل أرقام البطاقات بـ tokens، وينفذ عمليات التحقق اللازمة لمدفوعات البطاقات، لذلك لا تتعامل مع بيانات البطاقات الخام.

شبكات البطاقات المدعومة

يقبل Dodo Payments الشبكات العالمية وعدة شبكات إقليمية.

الشبكات العالمية

الشبكات الإقليمية

الإعداد

تستخدم البطاقات قيمتين في allowed_payment_method_types: تتيح هذه الجلسة الدفع بالبطاقات فقط:
أدرج كلًا من credit و debit ما لم يكن لديك سبب محدد لاستبعاد أحدهما. يفضل العديد من العملاء الدفع باستخدام بطاقة الخصم.

المصادقة باستخدام 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 لمعرفة نتيجة الدفع.

الاختبار

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

الأمان والامتثال

يطبّق Dodo Payments وسائل الحماية التالية على الدفعات بالبطاقات:

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

لا تقيّد أنواع البطاقات إلا عند الحاجة. يتوقع العملاء أن تعمل البطاقة التي يفضلونها.
اعرض شعارات Visa وMastercard وAmex على موقعك لبناء الثقة.
اعرض رسائل خطأ واضحة. لا تعرض رموز الخطأ الأولية للعملاء.
تجعل طرق الدفع المحفوظة عمليات الشراء المتكررة أسرع للعملاء العائدين.

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

الأسباب: رصيد غير كافٍ، أو بطاقة منتهية الصلاحية، أو CVV غير صحيح، أو حماية البنك من الاحتيال.الحل: اطلب من العميل التحقق من بياناته أو تجربة بطاقة أخرى. ابحث عن رمز خطأ الرفض والإجراء الموصى به في مرجع فشل المعاملات. راجع التعامل مع فشل الدفع لمعالجة حالات الرفض برمجيًا.
الأسباب: ترك العميل التحدي، أو كان نظام البنك غير متاح، أو انتهت مهلة التحدي.الحل: أعد المحاولة أو اطلب من العميل التواصل مع البنك. راجع التعامل مع فشل المصادقة لمعرفة حالات الدفع ورموز الرفض المعنية.
الأسباب: الشبكة الإقليمية غير مدعومة، أو البطاقة بطاقة مسبقة الدفع مقيّدة.الحل: اطلب من العميل تجربة بطاقة من شبكة رئيسية.

صفحات ذات صلة

Payment Methods Overview

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

Upsells & Downsells

عمليات الشراء بنقرة واحدة باستخدام البطاقات المحفوظة.

Testing Process

بيانات اختبار لكل طريقة دفع.

Subscriptions

الفوترة المتكررة باستخدام البطاقات.
آخر تعديل في ٢٨ سبتمبر ٢٠٢٦