Skip to main content
يدفع المتسوقون في منطقة آسيا والمحيط الهادئ باستخدام المحافظ الإلكترونية المحلية والتحويلات المصرفية الفورية بمعدل يفوق بكثير استخدام البطاقات الدولية. يدعم Dodo Payments كلاً من GCash (الفلبين)، وAlipay HK وFPS (هونغ كونغ)، وTouch ‘n Go (ماليزيا)، وتتم محاسبة كل منها بعملتها المحلية.
تغطي هذه الصفحة الفلبين وهونغ كونغ وماليزيا. للاطلاع على الأسواق الآسيوية الأخرى، راجع الهند لمعرفة UPI وRupay، وكوريا الجنوبية لمعرفة Kakao Pay وNaver Pay وPAYCO، وWeChat Pay للعملاء الصينيين.

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

Wallet-First Markets

تُعد GCash وTouch ‘n Go الطريقة الافتراضية للدفع عبر الإنترنت في الفلبين وماليزيا، وتتفوقان بفارق كبير على إدخال بيانات البطاقات.

Low Card Penetration

ملكية البطاقات محدودة في معظم أنحاء المنطقة. وتصل المحافظ المحلية وشبكات التحويل المصرفي إلى عملاء لا تصل إليهم عمليات الدفع التي تقتصر على البطاقات.

Instant Settlement

يُنجز FPS التحويلات المصرفية بين البنوك فورياً في هونغ كونغ، لذلك يتم تأكيد الدفعات أثناء عملية الدفع بدلاً من الانتظار لساعات.

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

الطرق الأربع كلها مخصصة للدفعات لمرة واحدة فقط. لا يدعم أي منها الاشتراكات أو أي رسوم متكررة أخرى. أدرج دائماً credit وdebit في عمليات دفع الاشتراكات حتى يتمكن العملاء في هذه الأسواق من التسجيل.
يدفع العملاء بعملتهم المحلية، وتتلقى أنت التسوية بعملة USD، كما هو الحال مع كل طريقة أخرى غير USD.

تفاصيل الطرق

تُعد GCash أكبر محفظة إلكترونية في الفلبين، وتُستخدم في كل شيء بدءاً من دفع الفواتير ووصولاً إلى التسوق عبر الإنترنت. يوافق العملاء على الدفع في تطبيق GCash ثم يُعادون إلى صفحة النجاح الخاصة بك.تتوفر في عمليات الدفع لمرة واحدة التي تتم فوترتها إلى الفلبين (PH) بعملة PHP.
Alipay HK هو إصدار Alipay الخاص بهونغ كونغ، ويُشغَّل للسوق المحلية وتتم تسويته بالدولار الهونغ كونغي. وهو طريقة منفصلة عن منتج Alipay الخاص بالبر الرئيسي للصين.يتوفر في عمليات الدفع لمرة واحدة التي تتم فوترتها إلى هونغ كونغ (HK) بعملة HKD. تتم تسوية Alipay HK بعملة HKD فقط، لذلك لا يظهر في عملية دفع بعملة CNY حتى عندما تكون دولة الفوترة هي هونغ كونغ.
FPS (نظام الدفع الأسرع) هو شبكة التحويلات الفورية بين البنوك في هونغ كونغ، وتديرها سلطة النقد في هونغ كونغ. يدفع العملاء مباشرةً من حساباتهم المصرفية، ويُنجز التحويل فوراً.يتوفر في عمليات الدفع لمرة واحدة التي تتم فوترتها إلى هونغ كونغ (HK) بعملة HKD أو CNY.
تُعد Touch ‘n Go المحفظة الإلكترونية الأكثر استخداماً في ماليزيا. يؤكد العملاء الدفع في تطبيق Touch ‘n Go ثم يعودون إلى صفحة النجاح الخاصة بك.تتوفر في عمليات الدفع لمرة واحدة التي تتم فوترتها إلى ماليزيا (MY) بعملة MYR.

التكوين

أنواع طرق API

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

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

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

المتطلبات

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

الاختبار

1

Enable test mode

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

Set the billing country and currency

أنشئ عملية دفع لمرة واحدة باستخدام دولة عنوان الفوترة وعملة الفوترة الخاصة بالطريقة التي تختبرها:أدرج نوع الطريقة في allowed_payment_method_types. لا يتم تقديم هذه الطرق في عمليات دفع الاشتراكات.
3

Select the method and confirm

حدد طريقة الدفع عند الدفع وانقر على الدفع. يظهر رمز QR في نافذة تراكب بملء الشاشة، وتنتظر عملية الدفع إتمام الدفعة.
4

Verify the checkout behavior

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

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

في الفلبين وماليزيا، تُعد المحفظة المحلية الطريقة الأساسية التي يتوقع العملاء الدفع بها. ويؤدي عرض GCash أو Touch ‘n Go إلى جانب البطاقات إلى تقليل التخلي عن عملية الدفع بشكل ملحوظ.
يخدم Alipay HK وFPS عملاء مختلفين — مستخدمي المحافظ ومستخدمي التحويلات المصرفية. أدرجهما معاً في عمليات الدفع بعملة HKD حتى يتمكن Dodo Payments من عرض الطريقة التي يفضلها العميل.
نظراً إلى أن كل طريقة في هذه الصفحة مخصصة للدفعات لمرة واحدة فقط، فلن يجد العميل ما يستخدمه في عملية دفع الاشتراك التي تعرض المحافظ المحلية فقط. أدرج دائماً credit وdebit للخطط المتكررة.
تتطلب هذه الطرق استخدام عملة الفوترة المحلية الخاصة بها. إذا كان كتالوجك مسعراً بعملة USD أو EUR، فعّل Adaptive Currency حتى يتم عرض الأسعار على العملاء وفوترتهم بعملات PHP أو HKD أو CNY أو MYR.

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

تحقق من التالي:
  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 مؤقتاً لرؤية كل الطرق المؤهلة، ثم حدّد الشرط الذي يفشل.
السبب: تتم تسوية Alipay HK بعملة HKD فقط. تعرض عملية الدفع المفوترة إلى هونغ كونغ بعملة CNY طريقة FPS، ولكنها لا تعرض Alipay HK مطلقاً.الحل: أجرِ الفوترة بعملة HKD لتقديم Alipay HK، أو أدرج fps لعمليات الدفع بعملة CNY في هونغ كونغ.
السبب: جميع طرق GCash وAlipay HK وFPS وTouch ‘n Go مخصصة للدفعات لمرة واحدة فقط، ولا يتم تقديمها مطلقاً للفوترة المتكررة.الحل: استخدم credit وdebit للاشتراكات في هذه الأسواق.
السبب: تعيد هذه الطرق توجيه العميل إلى تطبيق محفظة أو تطبيق مصرفي. إذا غادر العميل التطبيق، تظل الدفعة غير مكتملة.الحل: راقب webhooks لمعرفة حالة الدفع النهائية بدلاً من الاعتماد على إعادة التوجيه عند العودة. راجع دليل Webhooks.

صفحات ذات صلة

Payment Methods Overview

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

Adaptive Currency

أصدر فواتير للعملاء بعملتهم المحلية، بما في ذلك PHP وHKD وCNY وMYR.

Checkout Guide

دليل متكامل لتنفيذ عملية الدفع.

Testing Process

بيانات الاختبار وإرشادات اختبار عملية الدفع.
آخر تعديل في ٢٥ سبتمبر ٢٠٢٦