Skip to main content
تتيح المحافظ الرقمية للعملاء الدفع باستخدام بطاقة أو حساب محفوظ مسبقًا على أجهزتهم، من دون إدخال تفاصيل البطاقة. ترسل المحفظة رمزًا مميزًا بدلًا من رقم البطاقة، ويؤكد العميل الدفع بلمسة أو عبر التحقق البيومتري.

المحافظ المدعومة

يعرض Dodo Payments كل محفظة فقط عندما يتوافق إتمام الدفع مع بلد العميل وعملته ونوع الدفع:
PayPal غير متاح مؤقتًا للمعاملات الجديدة.

Apple Pay

يتيح Apple Pay للعملاء الدفع باستخدام البطاقات المحفوظة في Apple Wallet والتأكيد عبر Face ID أو Touch ID.
يظهر Apple Pay للاشتراكات حتى عندما تكون الدفعة الأولى $0، مثل الفترة التجريبية المجانية، حتى يتم إعداد تفويض الدفع عند التسجيل. أما في الدفعات لمرة واحدة، فلا يظهر Apple Pay إلا عندما يكون المبلغ أكبر من $0.

المتطلبات

  • الأجهزة: iOS 17 أو أحدث، أو iPadOS 17 أو أحدث، أو Safari 17 أو أحدث على macOS.
  • البروتوكول: يجب تحميل الصفحة عبر HTTPS.
  • النطاق: بالنسبة إلى إتمام الدفع المضمّن، يجب التحقق من النطاق باستخدام Apple.

التحقق من النطاق

لا يلزم التحقق من النطاق إلا لإتمام الدفع المضمّن (المدمج). يعرض إتمام الدفع المستضاف وروابط الدفع Apple Pay من دونه.
لا يتوفر Apple Pay في إتمام الدفع عبر التراكب. لتقديم Apple Pay، استخدم إتمام الدفع المضمّن أو إتمام الدفع المستضاف أو رابط دفع.
للتحقق من نطاق لإتمام الدفع المضمّن، اتبع الخطوات التالية في لوحة المعلومات:
1

Open Apple Pay Domains

انتقل إلى Settings → Payment Methods. في صف Apple Pay، انقر على Manage domains.
زر Manage domains في صف Apple Pay ضمن إعدادات Payment Methods

Open Apple Pay domains from the Apple Pay row

2

Download the Domain Association File

في لوحة Apple Pay domains، انقر على Download file.
لوحة Apple Pay domains التي تحتوي على زر Download file

Download the Apple Pay domain association file

3

Register Your Domain

انقر على Register domain، وأدخل النطاق الذي تضمّن فيه إتمام الدفع (مثل shop.example.com)، ثم انقر على Continue.
نموذج تسجيل نطاق مع إدخال نطاق

Register the domain where you embed checkout

4

Host the File on Your Domain

حمّل الملف إلى خادمك في هذا المسار:
قدّم الملف عبر HTTPS، من دون عمليات إعادة توجيه، باستخدام Content-Type: application/octet-stream أو text/plain.
5

Verify the Domain

انقر على Verify domain. يتحقق Dodo Payments من الملف المستضاف ويرسل نطاقك إلى Apple.
شاشة التحقق من النطاق مع مسار استضافة ملف الارتباط وزر Verify domain

Verify the hosted association file

6

Confirm It's Active

عندما تظهر الحالة Active، يصبح Apple Pay فعالًا على ذلك النطاق. لتشغيل Apple Pay أو إيقافه لنطاق واحد، استخدم مفتاح التبديل Enabled الخاص به.
قائمة نطاقات Apple Pay التي تعرض نطاقات بحالة Active ومفاتيح تبديل Enabled

Verified domains show an Active status

7

Test the Integration

  1. افتح إتمام الدفع على جهاز Apple.
  2. تحقق من ظهور زر Apple Pay.
  3. أكمل معاملة اختبارية.

الإعداد

لتقييد جلسة إتمام الدفع على Apple Pay والبطاقات، مرّر allowed_payment_method_types:

Google Pay

يتيح Google Pay للعملاء الدفع باستخدام البطاقات المحفوظة في حساب Google الخاص بهم.

المتطلبات

  • المتصفحات: Chrome على أجهزة الكمبيوتر المكتبية وAndroid، وFirefox على أجهزة الكمبيوتر المكتبية. لا يظهر Google Pay في Checkout على Safari أو في أي متصفح على iOS. في هذه المتصفحات، يمكن للعملاء الدفع باستخدام Apple Pay أو بطاقة.
  • الأجهزة: أجهزة Android التي يتوفر عليها تطبيق Google Pay.
  • الإعدادات: في Chrome، يجب تفعيل الإعداد Allow sites to check if you have payment methods saved.

الإعداد

لتقييد جلسة إتمام الدفع على Google Pay والبطاقات، مرّر allowed_payment_method_types:
لا يحتاج Google Pay إلى التحقق من النطاق.

Amazon Pay

يتيح Amazon Pay للعملاء إتمام الدفع باستخدام طرق الدفع المحفوظة في حساب Amazon الخاص بهم.

التوفر

  • المنطقة: عالمي، باستثناء الهند.
  • العملات: USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR. تعتمد العملات التي يقدمها إتمام الدفع على المعالج الذي يخدمه.
  • الاشتراكات: غير مدعومة.

الإعداد

لتقييد جلسة إتمام الدفع على Amazon Pay والبطاقات، مرّر allowed_payment_method_types:

Cash App Pay

يتيح Cash App Pay للعملاء في الولايات المتحدة الدفع من حساب Cash App الخاص بهم.

التوفر

  • المنطقة: الولايات المتحدة فقط. يجب أن تكون دولة الفوترة هي الولايات المتحدة.
  • العملة: USD فقط.
  • الاشتراكات: مدعومة.

الإعداد

لتقييد جلسة إتمام الدفع على Cash App Pay والبطاقات، مرّر allowed_payment_method_types:

RevolutPay

يتيح RevolutPay لمستخدمي Revolut الدفع من رصيد حساب Revolut الخاص بهم أو من البطاقات المرتبطة به.

التوفر

  • المنطقة: عالمي.
  • العملة: GBP فقط.
  • الاشتراكات: غير مدعومة.

الإعداد

لتقييد جلسة إتمام الدفع على RevolutPay والبطاقات، مرّر allowed_payment_method_types:

الاختبار

في وضع الاختبار، تمر مدفوعات المحافظ عبر سير عمل إتمام الدفع نفسه من دون نقل أموال حقيقية.

اختبار Apple Pay

1

Use Test Mode

أوقف مفتاح Live Mode في الشريط الجانبي للوحة المعلومات، واستخدم مفاتيح API التي أُنشئت في وضع الاختبار.
2

Add a Card to Apple Wallet

أضف بطاقة حقيقية إلى Apple Wallet. في وضع الاختبار، لن تُخصم قيمة البطاقة.
3

Complete a Test Purchase

افتح إتمام الدفع على جهاز Apple وأكمل تدفق Apple Pay.
يتطلب Apple Pay استخدام HTTPS. لن يظهر على localhost إلا إذا كانت الصفحة مقدمة عبر HTTPS.

اختبار Google Pay

1

Join the Test Card Group

انضم إلى مجموعة بطاقات اختبار Google Pay لإضافة بطاقات اختبار إلى محفظتك.
2

Enable Test Mode

استخدم مفاتيح API التي أُنشئت في وضع الاختبار.
3

Complete a Test Purchase

حدد إحدى بطاقات الاختبار في Google Pay لإكمال المعاملة.

Amazon Pay وCash App Pay

استخدم مفاتيح API الخاصة بوضع الاختبار واتبع سير عمل إتمام الدفع المعتاد. تتم محاكاة المعاملات الاختبارية ولا تُجرى أي عملية خصم حقيقية.

دعم SDK

يعتمد توفر المحافظ على طريقة عرض إتمام الدفع.

Web SDKs

تعمل المحافظ الرقمية في:
  • إتمام الدفع عبر التراكب، باستثناء Apple Pay.
  • إتمام الدفع المضمّن. يتطلب Apple Pay التحقق من النطاق.
  • تكامل API المباشر مع إتمام الدفع المستضاف.

Mobile SDKs (Checkout)

تفتح حزم SDK لإتمام الدفع الخاصة بـ Android وiOS و React Native و Flutter إتمام الدفع المستضاف من Dodo Payments في متصفح النظام على المنصة (SFSafariViewController على iOS، وChrome Custom Tabs على Android)، وليس في WebView. يعمل Apple Pay وGoogle Pay هناك بالطريقة نفسها التي يعملان بها على الويب. راجع دليل تكامل الأجهزة المحمولة للإعداد.

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

يتوقع العملاء على الأجهزة المحمولة Apple Pay وGoogle Pay. اعرض هذين الخيارين بشكل بارز في عمليات إتمام الدفع على الأجهزة المحمولة.
إذا كنت تستخدم إتمام الدفع المضمّن، فتحقق من نطاقك لـ Apple Pay أثناء التطوير، وليس يوم الإطلاق.
لا يمتلك كل العملاء محفظة رقمية. أدرج credit وdebit في allowed_payment_method_types.
لا تحاكي المحاكيات سلوك المحفظة بالكامل. اختبر على أجهزة iOS وAndroid حقيقية قبل الإطلاق.
لا تظهر المحفظة على جهاز غير مدعوم أو عندما لا يمتلك العميل بطاقات محفوظة. أبقِ طرق الدفع الأخرى ظاهرة لهؤلاء العملاء.

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

تحقق مما يلي:
  1. بالنسبة إلى إتمام الدفع المضمّن، هل تم التحقق من النطاق في Manage domains؟
  2. هل يتم تحميل الصفحة عبر HTTPS؟
  3. هل يعمل الجهاز بنظام iOS 17 أو iPadOS 17 أو Safari 17 أو إصدار أحدث؟
  4. هل لدى العميل بطاقات في Apple Wallet؟
  5. هل يتضمن apple_pay في allowed_payment_method_types؟
  6. هل إتمام الدفع عبارة عن تراكب؟ لا يتوفر Apple Pay في إتمام الدفع عبر التراكب.
الحل: أكمل التحقق من النطاق وقدّم الصفحة عبر HTTPS. اختبر على جهاز Apple حقيقي.
بعد النقر على Verify domain، يجلب Dodo Payments ملف الارتباط من نطاقك ويرسل النطاق إلى Apple. عادةً ما يعني بقاء النطاق في حالة Pending أن Dodo Payments لا يستطيع جلب الملف كما هو متوقع.تحقق مما يلي:
  1. يمكن الوصول إلى الملف على https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
  2. يتم تقديمه عبر HTTPS باستخدام شهادة صالحة.
  3. تتم تسويته من دون عمليات إعادة توجيه. تؤدي إعادة التوجيه إلى www أو إلى مضيف آخر أو إلى صفحة خطأ إلى فشل التحقق.
  4. يتم تقديمه بصيغة Content-Type: application/octet-stream أو text/plain، وليس text/html.
  5. إنه الملف الذي تم تنزيله من Manage domains لهذا النشاط التجاري، وليس ملفًا معاد استخدامه من حساب أو موفر آخر.
لتأكيد إمكانية الوصول إلى الملف بشكل عام، اطلب عنوان URL من خارج شبكتك الخاصة، مثلًا من نافذة تصفح خاصة. غالبًا ما تسمح كلمات مرور بيئة التجهيز وحواجز المصادقة وقواعد جدار الحماية بنجاح الطلب من جانبك، لكنها تمنعه من جانب Dodo Payments.الحل: أصلح مشكلة الاستضافة، ثم انقر على Verify domain مرة أخرى. إذا لم تصبح حالة النطاق Active بعد نجاح التحقق، فاتصل بـ support@dodopayments.com وأرسل اسم النطاق.
تحقق:
  1. هل يستخدم العميل متصفحًا مدعومًا؟ لا يظهر Google Pay في Safari أو في أي متصفح على iOS.
  2. هل لدى العميل بطاقات في Google Pay؟
  3. هل إعداد Chrome Allow sites to check if you have payment methods saved مفعّل؟
  4. هل يتضمن google_pay allowed_payment_method_types؟
الحل: تحقق من المتصفح وإعداد Google Pay لدى العميل.
الأسباب الشائعة:
  • البطاقة الموجودة في المحفظة منتهية الصلاحية أو غير صالحة.
  • رفض البنك المعاملة.
  • تسببت مشكلة في اتصال الشبكة في مقاطعة الدفع.
الحل: اطلب من العميل التحقق من البطاقة في محفظته أو استخدام طريقة دفع مختلفة.
تظهر المحافظ الرقمية على الأجهزة المتوافقة فقط:
  • Apple Pay: أجهزة Apple فقط.
  • Google Pay: أجهزة Chrome أو Android.
الحل: هذا متوقع. أبقِ مدفوعات البطاقات متاحة كخيار احتياطي.

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

Payment Methods Overview

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

Overlay Checkout

افتح إتمام الدفع كتراكب على صفحتك.

Testing Process

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

Mobile Integration Guide

افتح إتمام الدفع المستضاف في متصفح النظام، حيث يعمل Apple Pay وGoogle Pay كما يعملان على الويب.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦