> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> قم بقبول Apple Pay وGoogle Pay وAmazon Pay وCash App Pay وRevolutPay للحصول على تجربة تسوق سريعة وآمنة بنقرة واحدة. تعلم كيفية الإعداد والتحقق من النطاق والاختبار.

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

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

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

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

## Apple Pay

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

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

### المتطلبات

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

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

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

<Steps>
  <Step title="Open Wallet domains">
    في لوحتك الرئيسية، انتقل إلى **الإعدادات → طرق الدفع**، وفي صف **Apple Pay** انقر على **إدارة النطاقات**.

    <Frame caption="Open Wallet domains from the Apple Pay row">
      <img src="https://mintcdn.com/dodopayments/TklciB6vqCMDIBgH/images/apple-pay-domains/manage-domains.png?fit=max&auto=format&n=TklciB6vqCMDIBgH&q=85&s=a96c60ee0eef744336df955f5148c573" alt="زر إدارة النطاقات في صف Apple Pay في إعدادات طرق الدفع" style={{ maxHeight: '500px', width: 'auto' }} width="2940" height="1670" data-path="images/apple-pay-domains/manage-domains.png" />
    </Frame>
  </Step>

  <Step title="Download the domain association file">
    من لوحة نطاقات المحفظة، قم بتنزيل ملف الارتباط.

    <Frame caption="Download the Apple Pay domain association file">
      <img src="https://mintcdn.com/dodopayments/TklciB6vqCMDIBgH/images/apple-pay-domains/wallet-domains-panel.png?fit=max&auto=format&n=TklciB6vqCMDIBgH&q=85&s=fb37db780807c0e92ffaa57d2140b91d" alt="لوحة نطاقات المحفظة مع زر تنزيل الملف" style={{ maxHeight: '500px', width: 'auto' }} width="2940" height="1668" data-path="images/apple-pay-domains/wallet-domains-panel.png" />
    </Frame>
  </Step>

  <Step title="Register your domain">
    انقر على **تسجيل النطاق** وأدخل النطاق حيث تدرج الخروج (e.g., `shop.example.com`)، ثم **استمر**.

    <Frame caption="Register the domain where you embed checkout">
      <img src="https://mintcdn.com/dodopayments/TklciB6vqCMDIBgH/images/apple-pay-domains/register-domain.png?fit=max&auto=format&n=TklciB6vqCMDIBgH&q=85&s=9c2bf22e51c8ff188a4e11b36b24c136" alt="نموذج تسجيل النطاق مع نطاق مدخل" style={{ maxHeight: '500px', width: 'auto' }} width="2940" height="1672" data-path="images/apple-pay-domains/register-domain.png" />
    </Frame>
  </Step>

  <Step title="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`.
  </Step>

  <Step title="Verify the domain">
    انقر على **تحقق من النطاق**. تقوم Dodo Payments بفحص الملف المستضاف وتقديم نطاقك إلى Apple.

    <Frame caption="Verify the hosted association file">
      <img src="https://mintcdn.com/dodopayments/TklciB6vqCMDIBgH/images/apple-pay-domains/verify-domain.png?fit=max&auto=format&n=TklciB6vqCMDIBgH&q=85&s=e9fcfe5b68320a0a22c644fb935c840b" alt="شاشة التحقق من النطاق الخاص بك مع مسار ملف الارتباط وزر التحقق من النطاق" style={{ maxHeight: '500px', width: 'auto' }} width="2940" height="1674" data-path="images/apple-pay-domains/verify-domain.png" />
    </Frame>
  </Step>

  <Step title="Confirm it's active">
    عندما يظهر الحالة **نشط**، يكون Apple Pay متاحًا لهذا النطاق. استخدم التبديل **ممكّن** لتشغيله أو إيقافه لكل نطاق.

    <Frame caption="Verified domains show an Active status">
      <img src="https://mintcdn.com/dodopayments/TklciB6vqCMDIBgH/images/apple-pay-domains/domains-active.png?fit=max&auto=format&n=TklciB6vqCMDIBgH&q=85&s=51a2bf473b1faf3db5776bbfa7140854" alt="قائمة نطاقات المحفظة التي تعرض النطاقات مع حالة Apple Pay النشطة وتبديلات ممكّنة" style={{ maxHeight: '500px', width: 'auto' }} width="2940" height="1670" data-path="images/apple-pay-domains/domains-active.png" />
    </Frame>
  </Step>

  <Step title="Test the integration">
    1. افتح الخروج على جهاز Apple
    2. تحقق من ظهور زر Apple Pay
    3. أكمل عملية شراء اختبارية
  </Step>
</Steps>

### التكوين

```javascript theme={null}
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

### التكوين

```javascript theme={null}
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'
});
```

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

## Amazon Pay

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

### القيود

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

### التكوين

```javascript theme={null}
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 فقط
* **الاشتراكات:** غير مدعومة

### التكوين

```javascript theme={null}
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 فقط
* **الاشتراكات:** غير مدعومة

### التكوين

```javascript theme={null}
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

<Steps>
  <Step title="Use test mode">
    قم بتمكين وضع الاختبار في لوحة Dodo Payments الخاصة بك.
  </Step>

  <Step title="Add a card to Apple Wallet">
    أضف بطاقة حقيقية إلى Apple Wallet الخاص بك. في وضع الاختبار، لن تتم محاسبة البطاقة.
  </Step>

  <Step title="Complete test purchase">
    افتح الخروج على جهاز Apple وأكمل تدفق Apple Pay.
  </Step>
</Steps>

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

### اختبار Google Pay

<Steps>
  <Step title="Join the test card group">
    [انضم إلى مجموعة بطاقات الاختبار في Google Pay](https://groups.google.com/g/googlepay-test-mode-stub-data) للحصول على بطاقات الاختبار محملة تلقائيًا إلى محفظتك.
  </Step>

  <Step title="Enable test mode">
    استخدم مفاتيح API الاختبارية الخاصة بـ Dodo Payments.
  </Step>

  <Step title="Complete test purchase">
    اختر واحدة من بطاقات الاختبار في Google Pay لإكمال المعاملة.
  </Step>
</Steps>

### Amazon Pay & Cash App Pay

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

## دعم SDK

### Web SDKs

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

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

### Mobile SDKs

<Warning>
  **تقييد React Native:** Apple Pay وGoogle Pay وCash App Pay وUPI **غير مدعومة حاليًا** في SDK الخاص بـ React Native. استخدم تغليف الخروج المستند إلى الويب لتطبيقات الأجهزة المحمولة التي تحتاج إلى هذه الطرق.
</Warning>

لدعم الأجهزة المحمولة الأصلية، ضع في اعتبارك:

* فتح الخروج في WebView
* استخدام [Overlay Checkout](/developer-resources/overlay-checkout) في سياق الويب
* تنفيذ SDKs لـ Apple Pay / Google Pay الخاصة بالنظام الأساسي بشكل منفصل

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

<AccordionGroup>
  <Accordion title="Prioritize wallets on mobile">
    يتوقع مستخدمو الجوال Apple Pay وGoogle Pay. اعرض هذه الخيارات بشكل بارز على عمليات الخروج عبر الجوال.
  </Accordion>

  <Accordion title="Complete domain verification early">
    يتطلب Apple Pay التحقق من النطاق. لا تنتظر حتى يوم الإطلاق — ابدأ العملية أثناء التطوير.
  </Accordion>

  <Accordion title="Always include card fallbacks">
    ليس كل العملاء لديهم محافظ رقمية. قم دائمًا بتضمين `credit` و `debit` في طرقك المسموح بها.
  </Accordion>

  <Accordion title="Test on real devices">
    المحاكيات لا تعيد بشكل كامل سلوك المحفظة. اختبر على أجهزة iOS وAndroid الفعلية قبل الإطلاق.
  </Accordion>

  <Accordion title="Handle wallet unavailability gracefully">
    إذا لم تكن المحفظة متاحة (الجهاز الخطأ، لا توجد بطاقات محفوظة)، فتأكد من أن خيارات الدفع الأخرى مرئية.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Apple Pay button not appearing">
    **تحقق:**

    1. هل تم التحقق من النطاق مع Dodo Payments؟
    2. استخدام HTTPS؟
    3. الجهاز هو iOS 17+ / Safari 17+ / iPadOS 17+؟
    4. هل لدى العميل بطاقات في Apple Wallet؟
    5. هل تم تضمين `apple_pay` في `allowed_payment_method_types`؟

    **الحل:** أكمل تحقق النطاق وتأكد من HTTPS. قم بالاختبار على جهاز Apple حقيقي.
  </Accordion>

  <Accordion title="Google Pay button not appearing">
    **تحقق:**

    1. هل تستخدم Chrome أو متصفح متوافق؟
    2. هل لدى العميل بطاقات في Google Pay؟
    3. هل تم تمكين إعداد Chrome "السماح للمواقع بالتحقق من طرق الدفع"؟
    4. هل تم تضمين `google_pay` في `allowed_payment_method_types`؟

    **الحل:** تحقق من توافق المتصفح وإعداد Google Pay الخاص بالعميل.
  </Accordion>

  <Accordion title="Wallet payment failed">
    **الأسباب الشائعة:**

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

    **الحل:** يجب على العميل التحقق من البطاقة في محفظته أو تجربة طريقة دفع مختلفة.
  </Accordion>

  <Accordion title="Wrong device type">
    تظهر المحافظ الرقمية فقط على الأجهزة المتوافقة:

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

    **الحل:** هذا هو السلوك المتوقع. تأكد من توفر بطاقات بديلة.
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    انظر جميع طرق الدفع المدعومة.
  </Card>

  <Card title="Overlay Checkout" icon="window-restore" href="/developer-resources/overlay-checkout">
    قم بتنفيذ الخروج مع دعم المحفظة الرقمية.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    دليل اختبار كامل لجميع طرق الدفع.
  </Card>

  <Card title="React Native Integration" icon="mobile" href="/developer-resources/react-native-integration">
    وثائق SDK للهاتف المحمول والقيود.
  </Card>
</CardGroup>