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

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

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

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

المحفظة	التوفّر	العملات	الاشتراكات	الإعداد المطلوب
Apple Pay	عالمي، بما في ذلك الهند	جميع العملات، بما في ذلك INR	نعم	التحقق من النطاق لصفحة الدفع المضمّنة
Google Pay	عالمي (باستثناء الهند)	جميع العملات	نعم	لا شيء
Amazon Pay	عالمي (باستثناء الهند)	USD، EUR، GBP، AUD، CHF، DKK، HKD، JPY، NOK، NZD، SEK، ZAR	لا	لا شيء
Cash App Pay	الولايات المتحدة فقط	USD	نعم	لا شيء
RevolutPay	عالمي	GBP	لا	لا شيء

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

Apple Pay

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

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

المتطلبات

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

Apple Pay في الهند

يمكن للعملاء في الهند الدفع باستخدام Apple Pay في صفحات الدفع التي تتم محاسبتها بعملة INR. يعمل Apple Pay في الهند وفق الشروط التالية:

العملة: تتم محاسبة صفحة الدفع بعملة INR. ويجب أن تستوفي الدفعة المفوترة بعملة INR الحد الأدنى لـ INR.
البطاقات: لدى العميل بطاقة في Apple Wallet من بنك هندي يدعم Apple Pay. تتحكم Apple في البنوك والبطاقات المؤهلة.
سطح المكتب: في متصفح سطح المكتب، يمكن للعملاء مسح رمز باستخدام iPhone الخاص بهم وتأكيد الدفع على الهاتف.
الاشتراكات: تعمل اشتراكات Apple Pay بعملة INR وفق تفويضات RBI. تكتمل كل دفعة تجديد بعد نحو 48 ساعة من تاريخ التجديد، كما هو الحال مع البطاقات الأخرى المُصدرة في الهند.

لفوترة عميل في الهند بعملة INR، اتبع متطلبات طرق الدفع في الهند الخاصة ببلد الفوترة وAdaptive Currency.

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

لا يلزم التحقق من النطاق إلا لصفحة الدفع المضمّنة (inline). تعرض صفحة الدفع المستضافة وروابط الدفع Apple Pay من دونه.

لا يتوفر Apple Pay في صفحة الدفع بالتراكب. لتوفير Apple Pay، استخدم صفحة الدفع المضمّنة أو صفحة الدفع المستضافة أو رابط دفع.

للتحقق من نطاق لصفحة الدفع المضمّنة، اتبع الخطوات التالية في لوحة المعلومات:

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

Download the Domain Association File

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

لوحة Apple Pay domains مع زر Download file — Download the Apple Pay domain association file

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

نموذج تسجيل نطاق مع إدخال نطاق — 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

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

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

Confirm It's Active

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

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

Test the Integration

افتح صفحة الدفع على جهاز Apple.
تأكد من ظهور زر Apple Pay.
أكمل معاملة اختبار.

الإعداد

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

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

Google Pay

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

المتطلبات

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

الإعداد

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

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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، EUR، GBP، AUD، CHF، DKK، HKD، JPY، NOK، NZD، SEK، ZAR. تعتمد العملات التي تعرضها صفحة الدفع على المعالج الذي يخدمها.
الاشتراكات: غير مدعومة.

الإعداد

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

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_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 فقط.
الاشتراكات: مدعومة.

الإعداد

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

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

RevolutPay

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

التوفّر

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

الإعداد

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

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

الاختبار

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

اختبار Apple Pay

Use Test Mode

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

Add a Card to Apple Wallet

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

Complete a Test Purchase

افتح صفحة الدفع على جهاز Apple وأكمل عملية Apple Pay.

يتطلب Apple Pay استخدام HTTPS. ولا يظهر على localhost ما لم تُقدّم الصفحة عبر HTTPS.

اختبار Google Pay

Join the Test Card Group

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

Enable Test Mode

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

Complete a Test Purchase

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

Amazon Pay وCash App Pay

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

دعم SDK

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

Web SDKs

تعمل المحافظ الرقمية في:

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

Mobile SDKs (Checkout)

تفتح SDKs الخاصة بصفحة الدفع Android وiOS وReact Native وFlutter صفحة الدفع المستضافة من Dodo Payments في متصفح النظام على المنصة (SFSafariViewController على iOS، وChrome Custom Tabs على Android)، وليس داخل 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 في allowed_payment_method_types.

Test on real devices

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

Handle wallet unavailability

لا تظهر المحفظة على جهاز غير مدعوم أو عندما لا يملك العميل بطاقات محفوظة. أبقِ طرق الدفع الأخرى ظاهرة لهؤلاء العملاء.

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

Apple Pay button not appearing

تحقق من:

بالنسبة إلى صفحة الدفع المضمّنة، هل تم التحقق من النطاق في Manage domains؟
هل تُحمّل الصفحة عبر HTTPS؟
هل يعمل الجهاز بنظام iOS 17 أو iPadOS 17 أو Safari 17 أو إصدار أحدث؟
هل لدى العميل بطاقات في Apple Wallet؟
هل تم تضمين apple_pay في allowed_payment_method_types؟
هل صفحة الدفع عبارة عن تراكب؟ لا يتوفر Apple Pay في صفحة الدفع بالتراكب.

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

Apple Pay domain stuck on Pending

بعد النقر على Verify domain، يجلب Dodo Payments ملف الارتباط من نطاقك ويرسل النطاق إلى Apple. عادةً ما يعني بقاء النطاق في حالة Pending أن هناك مشكلة في الملف تمنع Dodo Payments من جلبه كما هو متوقع.تحقق من:

إمكانية الوصول إلى الملف على https://<your-domain>/.well-known/apple-developer-merchantid-domain-association.
تقديمه عبر HTTPS باستخدام شهادة صالحة.
حله من دون عمليات إعادة توجيه. تفشل عملية التحقق عند إعادة التوجيه إلى www أو إلى مضيف آخر أو إلى صفحة خطأ.
تقديمه على أنه Content-Type: application/octet-stream أو text/plain، وليس text/html.
كونه الملف الذي تم تنزيله من Manage domains لهذا النشاط التجاري، وليس ملفًا مُعاد استخدامه من حساب أو موفّر آخر.

للتأكد من إمكانية الوصول إلى الملف بشكل عام، اطلب عنوان URL من خارج شبكتك الخاصة، مثلًا في نافذة تصفح خاصة. غالبًا ما تسمح كلمات مرور بيئة التجهيز وجدران المصادقة وقواعد جدار الحماية بنجاح الطلب من جانبك، لكنها تمنعه من جانب Dodo Payments.الحل: أصلح مشكلة الاستضافة، ثم انقر على Verify domain مرة أخرى. إذا لم يصبح النطاق Active بعد نجاح التحقق، فاتصل بـ support@dodopayments.com مع ذكر اسم النطاق.

Google Pay button not appearing

تحقق من:

هل يستخدم العميل متصفحًا مدعومًا؟ لا يظهر Google Pay في Safari أو في أي متصفح على iOS.
هل لدى العميل بطاقات في Google Pay؟
هل إعداد Chrome Allow sites to check if you have payment methods saved مفعّل؟
هل تم تضمين 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

المتطلبات

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

​المتطلبات

​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

المتطلبات

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)

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

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

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