تغطي هذه الصفحة الفلبين وهونغ كونغ وماليزيا. للاطلاع على الأسواق الآسيوية الأخرى، راجع الهند لمعرفة UPI وRupay، وكوريا الجنوبية لمعرفة Kakao Pay وNaver Pay وPAYCO، وWeChat Pay للعملاء الصينيين.
أهمية المحافظ في منطقة آسيا والمحيط الهادئ
Wallet-First Markets
تُعد GCash المحفظة الرقمية الأكثر شعبية في الفلبين، بينما تُعد Touch ‘n Go أكبر محفظة إلكترونية في ماليزيا.
Low Card Penetration
يُعد استخدام بطاقات الائتمان منخفضًا في الفلبين مقارنةً بالأسواق التي تعتمد على البطاقات أولًا. وتصل المحافظ المحلية والتحويلات المصرفية إلى العملاء الذين لا تصل إليهم عملية إتمام الدفع المعتمدة على البطاقات فقط.
Instant Settlement
يعمل FPS على مدار الساعة في هونغ كونغ، وتصل الأموال إلى المستفيد تقريبًا بشكل فوري، لذلك يمكن لعملية إتمام الدفع تأكيد الدفع أثناء انتظار العميل.
طرق الدفع المدعومة
يسرد الجدول سوق كل طريقة وعملة الفوترة والحد الأدنى للمبلغ. الحد الأدنى هو الحد الأدنى عند إتمام الدفع بتلك العملة، ولذلك ينطبق على كل طريقة دفع في عملية إتمام دفع بهذه العملة.يدفع العملاء بعملتهم المحلية. وتُسوّى المدفوعات التي تتم باستخدام هذه الطرق الأربع في محفظة USD الخاصة بك. كما تُسوّى مدفوعات البطاقات في عملية إتمام الدفع نفسها بعملة USD.
تفاصيل الطريقة
GCash (Philippines)
GCash (Philippines)
تُعد GCash المحفظة الإلكترونية الأكثر شعبية في الفلبين. عند إتمام الدفع، يختار العميل GCash، وينقر على Pay، ثم يمسح رمز QR باستخدام تطبيق GCash للموافقة على الدفع.متاحة في عمليات إتمام الدفع لمرة واحدة المفوترة إلى الفلبين (
PH) بعملة PHP.Alipay HK (Hong Kong)
Alipay HK (Hong Kong)
Alipay HK هو إصدار Alipay الخاص بهونغ كونغ. يخدم السوق المحلية وتتم تسويته بالدولار الهونغ كونغي. وهو طريقة منفصلة عن منتج Alipay في برّ الصين الرئيسي. ويعرضها إتمام الدفع بالاسم AlipayHK.متاحة في عمليات إتمام الدفع لمرة واحدة المفوترة إلى هونغ كونغ (
HK) بعملة HKD. تتم تسوية Alipay HK بعملة HKD فقط، ولذلك لا تظهر في عملية إتمام دفع بعملة CNY، حتى عندما يكون بلد الفوترة هو هونغ كونغ.FPS (Hong Kong)
FPS (Hong Kong)
FPS (Faster Payment System) هو نظام الدفع الفوري في هونغ كونغ، وقد أطلقته سلطة النقد في هونغ كونغ. يربط بين البنوك والمحافظ الإلكترونية، ويعمل على مدار الساعة، ويدعم الدولار الهونغ كونغي واليوان الصيني. يمسح العميل رمز QR باستخدام تطبيق مصرفي أو تطبيق محفظة إلكترونية، وتصل الأموال تقريبًا بشكل فوري.متاحة في عمليات إتمام الدفع لمرة واحدة المفوترة إلى هونغ كونغ (
HK) إما بعملة HKD أو CNY.Touch 'n Go (Malaysia)
Touch 'n Go (Malaysia)
تُعد Touch ‘n Go أكبر محفظة إلكترونية في ماليزيا. يمسح العميل رمز QR باستخدام تطبيق Touch ‘n Go ويؤكد الدفع من خلاله.متاحة في عمليات إتمام الدفع لمرة واحدة المفوترة إلى ماليزيا (
MY) بعملة MYR.الإعداد
أنواع طرق API
مرّر هذه القيم فيallowed_payment_method_types:
مثال: إتمام الدفع في الفلبين
مثال: إتمام الدفع في هونغ كونغ
مثال: إتمام الدفع في ماليزيا
المتطلبات
لا تظهر الطريقة عند إتمام الدفع إلا عند تحقق جميع الشروط التالية:- يتطابق بلد الفوترة مع سوق الطريقة:
PHلـ GCash، وHKلـ Alipay HK وFPS، وMYلـ Touch ‘n Go. - تتطابق عملة الفوترة مع الطريقة: PHP أو HKD (أو CNY لـ FPS) أو MYR.
- تكون عملية إتمام الدفع دفعة لمرة واحدة وليست اشتراكًا.
- تكون Adaptive Currency مفعّلة. بدونها، يتم تجاهل
billing_currency، ولا يمكن لعملية إتمام الدفع إصدار الفاتورة بعملات PHP أو HKD أو CNY أو MYR.
الاختبار
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 في وضع الاختبار من بيئة الاختبار الخاصة بموفر المحفظة، وقد تعمل بشكل مختلف عن الدفع الفعلي.
أفضل الممارسات
Lead with the local wallet
Lead with the local wallet
في الفلبين وماليزيا، يتوقع العديد من العملاء الدفع باستخدام محفظة محلية. اعرض GCash أو Touch ‘n Go بجوار البطاقات في عمليات إتمام الدفع لهذه الأسواق.
Offer both Hong Kong methods
Offer both Hong Kong methods
يخدم Alipay HK وFPS عملاء مختلفين: مستخدمي المحافظ ومستخدمي التحويلات المصرفية. أدرجهما معًا في عمليات إتمام الدفع بعملة HKD حتى يرى كل عميل الطريقة التي يفضلها.
Keep cards on subscription checkouts
Keep cards on subscription checkouts
كل طريقة في هذه الصفحة متاحة لمرة واحدة فقط، لذلك لا تتضمن عملية إتمام دفع الاشتراك التي تعرض المحافظ المحلية فقط أي طريقة يمكن عرضها. أدرج
credit وdebit للخطط المتكررة.Match currency to region
Match currency to region
تتطلب هذه الطرق استخدام عملة الفوترة المحلية الخاصة بها. إذا كان كتالوجك مسعّرًا بعملة USD أو EUR، فعّل Adaptive Currency حتى يتم عرض الأسعار وفوترة العملاء بعملات PHP أو HKD أو CNY أو MYR.
استكشاف الأخطاء وإصلاحها
Method not appearing at checkout
Method not appearing at checkout
تحقق من التالي:
- هل بلد الفوترة هو
PHأوHKأوMY، بما يتطابق مع الطريقة؟ - هل عملة الفوترة هي PHP أو HKD أو CNY أو MYR، بما يتطابق مع الطريقة؟
- هل هذه دفعة لمرة واحدة؟ لا تظهر أي من هذه الطرق في الاشتراكات.
- هل الطريقة (
gcashأوali_pay_hkأوfpsأوtouch_n_go) مضمنة فيallowed_payment_method_types؟ - هل Adaptive Currency مفعّلة؟
- هل يستوفي المبلغ الحد الأدنى للعملة في الطرق المدعومة؟
allowed_payment_method_types مؤقتًا لرؤية كل طريقة مؤهلة، ثم حدد الشرط الذي لم يتحقق.Alipay HK missing on a CNY checkout
Alipay HK missing on a CNY checkout
السبب: تتم تسوية Alipay HK بعملة HKD فقط. وتوفر عملية إتمام الدفع المفوترة إلى هونغ كونغ بعملة CNY طريقة FPS، ولكنها لا توفر Alipay HK مطلقًا.الحل: أصدر الفاتورة بعملة HKD لتوفير Alipay HK، أو أدرج
fps لعمليات إتمام الدفع بعملة CNY في هونغ كونغ.Wallet missing on a subscription
Wallet missing on a subscription
السبب: GCash وAlipay HK وFPS وTouch ‘n Go متاحة لمرة واحدة فقط ولا تُعرض للفوترة المتكررة.الحل: استخدم
credit وdebit للاشتراكات في هذه الأسواق.Payment not confirming
Payment not confirming
السبب: يجب على العميل مسح رمز QR والموافقة على الدفع في تطبيق محفظة أو تطبيق مصرفي. إذا أغلق العميل التطبيق قبل الموافقة، يظل الدفع غير مكتمل.الحل: استخدم webhooks للحصول على حالة الدفع النهائية بدلًا من إعادة التوجيه بعد العودة. راجع دليل Webhooks.
صفحات ذات صلة
Payment Methods Overview
اطّلع على جميع طرق الدفع المدعومة.
Adaptive Currency
أصدر الفواتير للعملاء بعملتهم المحلية، بما في ذلك PHP وHKD وCNY وMYR.
Checkout Guide
دليل تنفيذ إتمام الدفع بالكامل.
Testing Process
بيانات الاختبار وإرشادات اختبار إتمام الدفع.