Skip to main content
دع العملاء في الفلبين وهونغ كونغ وماليزيا يدفعون باستخدام المحفظة أو التحويل المصرفي الذي يستخدمونه يوميًا. يدعم Dodo Payments كلاً من GCash (الفلبين)، وAlipay HK وFPS (هونغ كونغ)، وTouch ‘n Go (ماليزيا) ضمن المدفوعات لمرة واحدة. تتم فوترة كل طريقة بعملتها المحلية، ويدفع العميل عبر مسح رمز QR الظاهر عند إتمام الدفع.
تغطي هذه الصفحة الفلبين وهونغ كونغ وماليزيا. للاطلاع على الأسواق الآسيوية الأخرى، راجع الهند لمعرفة 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، وينقر على Pay، ثم يمسح رمز QR باستخدام تطبيق GCash للموافقة على الدفع.متاحة في عمليات إتمام الدفع لمرة واحدة المفوترة إلى الفلبين (PH) بعملة PHP.
Alipay HK هو إصدار Alipay الخاص بهونغ كونغ. يخدم السوق المحلية وتتم تسويته بالدولار الهونغ كونغي. وهو طريقة منفصلة عن منتج Alipay في برّ الصين الرئيسي. ويعرضها إتمام الدفع بالاسم AlipayHK.متاحة في عمليات إتمام الدفع لمرة واحدة المفوترة إلى هونغ كونغ (HK) بعملة HKD. تتم تسوية Alipay HK بعملة HKD فقط، ولذلك لا تظهر في عملية إتمام دفع بعملة CNY، حتى عندما يكون بلد الفوترة هو هونغ كونغ.
FPS (Faster Payment System) هو نظام الدفع الفوري في هونغ كونغ، وقد أطلقته سلطة النقد في هونغ كونغ. يربط بين البنوك والمحافظ الإلكترونية، ويعمل على مدار الساعة، ويدعم الدولار الهونغ كونغي واليوان الصيني. يمسح العميل رمز QR باستخدام تطبيق مصرفي أو تطبيق محفظة إلكترونية، وتصل الأموال تقريبًا بشكل فوري.متاحة في عمليات إتمام الدفع لمرة واحدة المفوترة إلى هونغ كونغ (HK) إما بعملة HKD أو CNY.
تُعد Touch ‘n Go أكبر محفظة إلكترونية في ماليزيا. يمسح العميل رمز QR باستخدام تطبيق Touch ‘n Go ويؤكد الدفع من خلاله.متاحة في عمليات إتمام الدفع لمرة واحدة المفوترة إلى ماليزيا (MY) بعملة MYR.

الإعداد

أنواع طرق API

مرّر هذه القيم في allowed_payment_method_types:

مثال: إتمام الدفع في الفلبين

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

مثال: إتمام الدفع في ماليزيا

المتطلبات

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

الاختبار

1

Enable test mode

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

Set the billing country and currency

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

Select the method and confirm

حدد طريقة الدفع عند إتمام الدفع وانقر على Pay. يفتح رمز QR في طبقة تراكب بملء الشاشة مع عدّ تنازلي مدته 10 دقائق، وتتحقق عملية إتمام الدفع من حالة الدفع أثناء بقاء الطبقة مفتوحة.
4

Verify the checkout behavior

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

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

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

صفحات ذات صلة

Payment Methods Overview

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

Adaptive Currency

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

Checkout Guide

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

Testing Process

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