> ## 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.

# طرق الدفع في منطقة آسيا والمحيط الهادئ

> اقبل GCash في الفلبين، وAlipay HK وFPS في هونغ كونغ، وTouch 'n Go في ماليزيا. تعرّف على متطلبات العملة، ودعم الدفعات لمرة واحدة، وإعدادات التكوين.

يدفع المتسوقون في منطقة آسيا والمحيط الهادئ باستخدام المحافظ الإلكترونية المحلية والتحويلات المصرفية الفورية بمعدل يفوق بكثير استخدام البطاقات الدولية. يدعم Dodo Payments كلاً من **GCash** (الفلبين)، و**Alipay HK** و**FPS** (هونغ كونغ)، و**Touch 'n Go** (ماليزيا)، وتتم محاسبة كل منها بعملتها المحلية.

<Note>
  تغطي هذه الصفحة الفلبين وهونغ كونغ وماليزيا. للاطلاع على الأسواق الآسيوية الأخرى، راجع [الهند](/features/payment-methods/india) لمعرفة UPI وRupay، و[كوريا الجنوبية](/features/payment-methods/south-korea) لمعرفة Kakao Pay وNaver Pay وPAYCO، و[WeChat Pay](/features/payment-methods/wechat) للعملاء الصينيين.
</Note>

## أهمية المحافظ في منطقة آسيا والمحيط الهادئ

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    تُعد GCash وTouch 'n Go الطريقة الافتراضية للدفع عبر الإنترنت في الفلبين وماليزيا، وتتفوقان بفارق كبير على إدخال بيانات البطاقات.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    ملكية البطاقات محدودة في معظم أنحاء المنطقة. وتصل المحافظ المحلية وشبكات التحويل المصرفي إلى عملاء لا تصل إليهم عمليات الدفع التي تقتصر على البطاقات.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    يُنجز FPS التحويلات المصرفية بين البنوك فورياً في هونغ كونغ، لذلك يتم تأكيد الدفعات أثناء عملية الدفع بدلاً من الانتظار لساعات.
  </Card>
</CardGroup>

## طرق الدفع المدعومة

| الطريقة         | الدولة    | عملة الفوترة | الاشتراكات | الحد الأدنى للمبلغ  |
| :-------------- | :-------- | :----------- | :--------: | :------------------ |
| **GCash**       | الفلبين   | PHP          |     لا     | 50.00 PHP           |
| **Alipay HK**   | هونغ كونغ | HKD          |     لا     | 4.00 HKD            |
| **FPS**         | هونغ كونغ | HKD, CNY     |     لا     | 4.00 HKD / 4.00 CNY |
| **Touch 'n Go** | ماليزيا   | MYR          |     لا     | 4.00 MYR            |

<Warning>
  **الطرق الأربع كلها مخصصة للدفعات لمرة واحدة فقط.** لا يدعم أي منها الاشتراكات أو أي رسوم متكررة أخرى. أدرج دائماً `credit` و`debit` في عمليات دفع الاشتراكات حتى يتمكن العملاء في هذه الأسواق من التسجيل.
</Warning>

<Info>
  يدفع العملاء بعملتهم المحلية، وتتلقى أنت التسوية بعملة **USD**، كما هو الحال مع كل طريقة أخرى غير USD.
</Info>

### تفاصيل الطرق

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    تُعد GCash أكبر محفظة إلكترونية في الفلبين، وتُستخدم في كل شيء بدءاً من دفع الفواتير ووصولاً إلى التسوق عبر الإنترنت. يوافق العملاء على الدفع في تطبيق GCash ثم يُعادون إلى صفحة النجاح الخاصة بك.

    تتوفر في عمليات الدفع **لمرة واحدة** التي تتم فوترتها إلى **الفلبين (`PH`)** بعملة **PHP**.
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK هو إصدار Alipay الخاص بهونغ كونغ، ويُشغَّل للسوق المحلية وتتم تسويته بالدولار الهونغ كونغي. وهو طريقة منفصلة عن منتج Alipay الخاص بالبر الرئيسي للصين.

    يتوفر في عمليات الدفع **لمرة واحدة** التي تتم فوترتها إلى **هونغ كونغ (`HK`)** بعملة **HKD**. تتم تسوية Alipay HK بعملة HKD فقط، لذلك لا يظهر في عملية دفع بعملة CNY حتى عندما تكون دولة الفوترة هي هونغ كونغ.
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    FPS (نظام الدفع الأسرع) هو شبكة التحويلات الفورية بين البنوك في هونغ كونغ، وتديرها سلطة النقد في هونغ كونغ. يدفع العملاء مباشرةً من حساباتهم المصرفية، ويُنجز التحويل فوراً.

    يتوفر في عمليات الدفع **لمرة واحدة** التي تتم فوترتها إلى **هونغ كونغ (`HK`)** بعملة **HKD** أو **CNY**.
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    تُعد Touch 'n Go المحفظة الإلكترونية الأكثر استخداماً في ماليزيا. يؤكد العملاء الدفع في تطبيق Touch 'n Go ثم يعودون إلى صفحة النجاح الخاصة بك.

    تتوفر في عمليات الدفع **لمرة واحدة** التي تتم فوترتها إلى **ماليزيا (`MY`)** بعملة **MYR**.
  </Accordion>
</AccordionGroup>

## التكوين

### أنواع طرق API

| النوع        | الوصف                                |
| :----------- | :----------------------------------- |
| `gcash`      | محفظة GCash (الفلبين)                |
| `ali_pay_hk` | محفظة Alipay HK (هونغ كونغ)          |
| `fps`        | تحويل مصرفي فوري عبر FPS (هونغ كونغ) |
| `touch_n_go` | محفظة Touch 'n Go (ماليزيا)          |

### مثال: عملية دفع في الفلبين

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['gcash', 'credit', 'debit'],
  billing_currency: 'PHP',
  billing_address: {
    country: 'PH',
    zipcode: '1226'
  },
  return_url: 'https://example.com/success'
});
```

### مثال: عملية دفع في هونغ كونغ

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ali_pay_hk', 'fps', 'credit', 'debit'],
  billing_currency: 'HKD',
  billing_address: {
    country: 'HK',
    zipcode: '999077'
  },
  return_url: 'https://example.com/success'
});
```

### مثال: عملية دفع في ماليزيا

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['touch_n_go', 'credit', 'debit'],
  billing_currency: 'MYR',
  billing_address: {
    country: 'MY',
    zipcode: '50450'
  },
  return_url: 'https://example.com/success'
});
```

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

لكي تظهر هذه الطرق عند الدفع:

1. **دولة الفوترة** تطابق سوق الطريقة — `PH` لـ GCash، و`HK` لـ Alipay HK وFPS، و`MY` لـ Touch 'n Go
2. **العملة** تطابق الطريقة — PHP أو HKD (أو CNY لـ FPS) أو MYR
3. **نوع الدفع** هو دفعة لمرة واحدة، وليس اشتراكاً
4. بالنسبة إلى التجار الذين يحددون الأسعار بعملة أخرى: يجب تفعيل **[Adaptive Currency](/features/adaptive-currency)** حتى تتم محاسبة العملاء بالعملة المحلية

<Warning>
  إذا حددت الأسعار بعملة أخرى ولم يتم تفعيل Adaptive Currency، فلن تتم محاسبة العملاء في هذه الأسواق بالعملة المحلية، ولن تتوفر أي من هذه الطرق.
</Warning>

## الاختبار

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

  <Step title="Set the billing country and currency">
    أنشئ عملية دفع لمرة واحدة باستخدام دولة عنوان الفوترة وعملة الفوترة الخاصة بالطريقة التي تختبرها:

    | الطريقة     | دولة الفوترة | عملة الفوترة   |
    | :---------- | :----------- | :------------- |
    | GCash       | `PH`         | `PHP`          |
    | Alipay HK   | `HK`         | `HKD`          |
    | FPS         | `HK`         | `HKD` أو `CNY` |
    | Touch 'n Go | `MY`         | `MYR`          |

    أدرج نوع الطريقة في `allowed_payment_method_types`. لا يتم تقديم هذه الطرق في عمليات دفع الاشتراكات.
  </Step>

  <Step title="Select the method and confirm">
    حدد طريقة الدفع عند الدفع وانقر على **الدفع**. يظهر رمز QR في نافذة تراكب بملء الشاشة، وتنتظر عملية الدفع إتمام الدفعة.
  </Step>

  <Step title="Verify the checkout behavior">
    تأكد من ظهور الطريقة فقط للدولة والعملة المطابقتين، ومن عرض رمز QR بشكل صحيح.
  </Step>
</Steps>

<Note>
  تُصدر رموز QR في وضع الاختبار بواسطة بيئة الاختبار الخاصة بموفر المحفظة، وقد تتصرف بشكل مختلف عن الدفعة الفعلية.
</Note>

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

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    في الفلبين وماليزيا، تُعد المحفظة المحلية الطريقة الأساسية التي يتوقع العملاء الدفع بها. ويؤدي عرض GCash أو Touch 'n Go إلى جانب البطاقات إلى تقليل التخلي عن عملية الدفع بشكل ملحوظ.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    يخدم Alipay HK وFPS عملاء مختلفين — مستخدمي المحافظ ومستخدمي التحويلات المصرفية. أدرجهما معاً في عمليات الدفع بعملة HKD حتى يتمكن Dodo Payments من عرض الطريقة التي يفضلها العميل.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    نظراً إلى أن كل طريقة في هذه الصفحة مخصصة للدفعات لمرة واحدة فقط، فلن يجد العميل ما يستخدمه في عملية دفع الاشتراك التي تعرض المحافظ المحلية فقط. أدرج دائماً `credit` و`debit` للخطط المتكررة.
  </Accordion>

  <Accordion title="Match currency to region">
    تتطلب هذه الطرق استخدام عملة الفوترة المحلية الخاصة بها. إذا كان كتالوجك مسعراً بعملة USD أو EUR، فعّل Adaptive Currency حتى يتم عرض الأسعار على العملاء وفوترتهم بعملات PHP أو HKD أو CNY أو MYR.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **تحقق من التالي:**

    1. هل تم تعيين دولة الفوترة إلى `PH` أو `HK` أو `MY` بما يطابق الطريقة؟
    2. هل تم تعيين عملة الفوترة إلى PHP أو HKD أو CNY أو MYR بما يطابق الطريقة؟
    3. هل هذه دفعة لمرة واحدة؟ لا تظهر أي من هذه الطرق في الاشتراكات.
    4. هل تم تضمين الطريقة (`gcash` أو `ali_pay_hk` أو `fps` أو `touch_n_go`) في `allowed_payment_method_types`؟
    5. إذا تم تحديد السعر بعملة أخرى: هل تم تفعيل Adaptive Currency؟

    **الحل:** أزل `allowed_payment_method_types` مؤقتاً لرؤية كل الطرق المؤهلة، ثم حدّد الشرط الذي يفشل.
  </Accordion>

  <Accordion title="Alipay HK missing on a CNY checkout">
    **السبب:** تتم تسوية Alipay HK بعملة HKD فقط. تعرض عملية الدفع المفوترة إلى هونغ كونغ بعملة CNY طريقة FPS، ولكنها لا تعرض Alipay HK مطلقاً.

    **الحل:** أجرِ الفوترة بعملة HKD لتقديم Alipay HK، أو أدرج `fps` لعمليات الدفع بعملة CNY في هونغ كونغ.
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **السبب:** جميع طرق GCash وAlipay HK وFPS وTouch 'n Go مخصصة للدفعات لمرة واحدة فقط، ولا يتم تقديمها مطلقاً للفوترة المتكررة.

    **الحل:** استخدم `credit` و`debit` للاشتراكات في هذه الأسواق.
  </Accordion>

  <Accordion title="Payment not confirming">
    **السبب:** تعيد هذه الطرق توجيه العميل إلى تطبيق محفظة أو تطبيق مصرفي. إذا غادر العميل التطبيق، تظل الدفعة غير مكتملة.

    **الحل:** راقب webhooks لمعرفة حالة الدفع النهائية بدلاً من الاعتماد على إعادة التوجيه عند العودة. راجع [دليل Webhooks](/developer-resources/webhooks).
  </Accordion>
</AccordionGroup>

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

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

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    أصدر فواتير للعملاء بعملتهم المحلية، بما في ذلك PHP وHKD وCNY وMYR.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    دليل متكامل لتنفيذ عملية الدفع.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    بيانات الاختبار وإرشادات اختبار عملية الدفع.
  </Card>
</CardGroup>