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

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

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

المحفظة	التوفر	العملات	الاشتراكات	الإعداد المطلوب
Apple Pay	عالمي (باستثناء الهند)	جميعها	نعم	تحقق من النطاق
Google Pay	عالمي (باستثناء الهند)	جميعها	نعم	لا شيء
Amazon Pay	عالمي (باستثناء الهند)	USD	لا	لا شيء
Cash App Pay	الولايات المتحدة فقط	USD	لا	لا شيء
RevolutPay	عالمي	GBP	لا	لا شيء

تم إيقاف دعم PayPal مؤقتًا: PayPal غير متاح مؤقتًا للمعاملات الجديدة.

Apple Pay

تسمح Apple Pay للعملاء بالدفع باستخدام بطاقات محفوظة في محفظة Apple الخاصة بهم، مع المصادقة باستخدام Face ID أو Touch ID.

Apple Pay متاح للاشتراكات حتى عندما تكون أول رسوم **

0** (مثل الفترات التجريبية المجانية) حتى يمكن إعداد التفويض بالدفع عند التسجيل. بالنسبة للمدفوعات لمرة واحدة، يظهر Apple Pay فقط عندما يكون المبلغ أكبر من

المتطلبات

الأجهزة: iOS 17+، iPadOS 17+، Safari 17+ على macOS
البروتوكول: مطلوب HTTPS
النطاق: يجب أن يكون تم التحقق منه بواسطة Apple

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

التحقق من النطاق مطلوب فقط لـ الخروج المضمّن (المتداخل). لا يحتاج الخروج المتراكب أو المستضاف وروابط الدفع إلى ذلك.

Open Wallet domains

في لوحتك الرئيسية، انتقل إلى الإعدادات → طرق الدفع، وفي صف Apple Pay انقر على إدارة النطاقات.

زر إدارة النطاقات في صف Apple Pay في إعدادات طرق الدفع — Open Wallet domains from the Apple Pay row

Download the domain association file

من لوحة نطاقات المحفظة، قم بتنزيل ملف الارتباط.

لوحة نطاقات المحفظة مع زر تنزيل الملف — Download the Apple Pay domain association file

انقر على تسجيل النطاق وأدخل النطاق حيث تدرج الخروج (e.g., shop.example.com)، ثم استمر.

نموذج تسجيل النطاق مع نطاق مدخل — Register the domain where you embed checkout

Host the file on your domain

حمّل إلى الخادم الخاص بك في:

https://shop.example.com/.well-known/apple-developer-merchantid-domain-association

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

Verify the domain

انقر على تحقق من النطاق. تقوم Dodo Payments بفحص الملف المستضاف وتقديم نطاقك إلى Apple.

شاشة التحقق من النطاق الخاص بك مع مسار ملف الارتباط وزر التحقق من النطاق — Verify the hosted association file

Confirm it's active

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

قائمة نطاقات المحفظة التي تعرض النطاقات مع حالة Apple Pay النشطة وتبديلات ممكّنة — Verified domains show an Active status

Test the integration

افتح الخروج على جهاز Apple
تحقق من ظهور زر Apple Pay
أكمل عملية شراء اختبارية

التكوين

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['apple_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Google Pay

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

المتطلبات

المتصفحات: Chrome (سطح المكتب/موبايل)، Safari، Firefox
الأجهزة: أجهزة Android مع تطبيق Google Pay
الإعدادات: تمكين “السماح للمواقع بالتحقق مما إذا كان لديك طرق دفع” في Chrome

التكوين

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['google_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

لا حاجة للتحقق من النطاق لـ Google Pay — يعمل تلقائيًا بمجرد أن يصبح حسابك مباشرًا.

Amazon Pay

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

القيود

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

التكوين

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['amazon_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Cash App Pay

يمكن Cash App Pay من الدفع من خلال Cash App، المنتشر بين المستهلكين في الولايات المتحدة للدفع من شخص لآخر.

القيود

المنطقة: الولايات المتحدة فقط
العملة: USD فقط
الاشتراكات: غير مدعومة

التكوين

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['cashapp', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

RevolutPay

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

القيود

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

التكوين

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['revolut_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

الاختبار

اختبار Apple Pay

Use test mode

قم بتمكين وضع الاختبار في لوحة Dodo Payments الخاصة بك.

Add a card to Apple Wallet

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

Complete test purchase

افتح الخروج على جهاز Apple وأكمل تدفق Apple Pay.

يتطلب Apple Pay HTTPS. لن يظهر على localhost دون إعداد SSL مناسب.

اختبار Google Pay

Join the test card group

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

Enable test mode

استخدم مفاتيح API الاختبارية الخاصة بـ Dodo Payments.

Complete test purchase

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

Amazon Pay & Cash App Pay

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

دعم SDK

Web SDKs

جميع المحافظ الرقمية مدعومة بالكامل في:

Overlay Checkout
Inline Checkout
تكامل API المباشر

حِزم Mobile SDKs (Checkout)

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

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

Prioritize wallets on mobile

يتوقع مستخدمو الأجهزة المحمولة استخدام Apple Pay وGoogle Pay. اعرض هذه الخيارات بشكل بارز في صفحات الدفع على الأجهزة المحمولة.

Complete domain verification early

يتطلب Apple Pay التحقق من النطاق. لا تنتظر حتى يوم الإطلاق — ابدأ العملية أثناء التطوير.

Always include card fallbacks

لا يمتلك جميع العملاء محافظ رقمية. احرص دائمًا على تضمين credit وdebit في طرق الدفع المسموح بها.

Test on real devices

لا تحاكي المحاكيات سلوك المحافظ بالكامل. اختبر على أجهزة iOS وAndroid فعلية قبل الإطلاق.

Handle wallet unavailability gracefully

إذا لم تكن المحفظة متاحة (بسبب استخدام جهاز غير مناسب أو عدم حفظ أي بطاقات)، فتأكد من ظهور خيارات الدفع الأخرى.

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

Apple Pay button not appearing

تحقق من:

هل تم التحقق من النطاق باستخدام Dodo Payments؟
هل تستخدم HTTPS؟
هل الجهاز يعمل بنظام iOS 17+ / Safari 17+ / iPadOS 17+؟
هل لدى العميل بطاقات في Apple Wallet؟
هل تم تضمين apple_pay في allowed_payment_method_types؟

الحل: أكمل عملية التحقق من النطاق وتأكد من استخدام HTTPS. اختبر على جهاز Apple حقيقي.

Google Pay button not appearing

تحقق من:

هل تستخدم Chrome أو متصفحًا متوافقًا؟
هل لدى العميل بطاقات في Google Pay؟
هل إعداد Chrome “السماح للمواقع بالتحقق من طرق الدفع” مفعّل؟
هل تم تضمين google_pay في allowed_payment_method_types؟

الحل: تحقق من توافق المتصفح ومن إعداد Google Pay لدى العميل.

Wallet payment failed

الأسباب الشائعة:

انتهت صلاحية البطاقة الموجودة في المحفظة أو أصبحت غير صالحة
رفض البنك المعاملة
مشكلة في اتصال الشبكة

الحل: ينبغي للعميل التحقق من البطاقة الموجودة في محفظته أو تجربة طريقة دفع مختلفة.

Wrong device type

لا تظهر المحافظ الرقمية إلا على الأجهزة المتوافقة:

Apple Pay: أجهزة Apple فقط
Google Pay: متصفح Chrome أو أجهزة Android

الحل: هذا سلوك متوقع. تأكد من توفر بدائل للبطاقات.

صفحات ذات صلة

Payment Methods Overview

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

Overlay Checkout

نفّذ صفحة الدفع مع دعم المحافظ الرقمية.

Testing Process

دليل اختبار شامل لجميع طرق الدفع.

Mobile Integration Guide

يفتح صفحة الدفع المستضافة في علامة تبويب متصفح أصلية — يعمل Apple Pay وGoogle Pay بالطريقة نفسها التي يعملان بها على الويب.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Apple Pay

المتطلبات

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

التكوين

Google Pay

المتطلبات

التكوين

Amazon Pay

القيود

التكوين

Cash App Pay

القيود

التكوين

RevolutPay

القيود

التكوين

الاختبار

اختبار Apple Pay

اختبار Google Pay

Amazon Pay & Cash App Pay

دعم SDK

Web SDKs

حِزم Mobile SDKs (Checkout)

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

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

صفحات ذات صلة

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

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

​Apple Pay

​المتطلبات

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

​التكوين

​Google Pay

​المتطلبات

​التكوين

​Amazon Pay

​القيود

​التكوين

​Cash App Pay

​القيود

​التكوين

​RevolutPay

​القيود

​التكوين

​الاختبار

​اختبار Apple Pay

​اختبار Google Pay

​Amazon Pay & Cash App Pay

​دعم SDK

​Web SDKs

​حِزم Mobile SDKs (Checkout)

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

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

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

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

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

Apple Pay

المتطلبات

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

التكوين

Google Pay

المتطلبات

التكوين

Amazon Pay

القيود

التكوين

Cash App Pay

القيود

التكوين

RevolutPay

القيود

التكوين

الاختبار

اختبار Apple Pay

اختبار Google Pay

Amazon Pay & Cash App Pay

دعم SDK

Web SDKs

حِزم Mobile SDKs (Checkout)

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

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

صفحات ذات صلة