قائمة التحقّق الخاصة بالدمج

استخدِم قائمة التحقّق التالية للتأكّد من إكمال جميع الخطوات المطلوبة في عملية الدمج على الويب.

لمحة عن بيئة الاختبار

لا تعرض إعدادات اختبار Google Pay API معلومات دفع مباشرة وقابلة للتحصيل، بل تتيح لك اختبار عناصر سير عمل عملية الشراء. في ما يلي العناصر التي يمكن اختبارها:

  • صفحات التأكيد
  • الإيصالات
  • عنوان إرسال الفواتير (اختياري)
  • رقم هاتف الفوترة (اختياري)
  • عنوان الشحن (اختياري)
  • عنوان البريد الإلكتروني (اختياري)

لاستخدام بيئة اختبار مع استجابة مثال لبيانات الدفع، عليك تهيئة PaymentsClient جديد باستخدام عنصر JavaScript يحتوي على سمة بيئة تم ضبطها على TEST.

في ما يلي عيّنة من الرمز البرمجي: 
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

الاختبار باستخدام "وحدة تحكّم المطوّرين" في المتصفّح

اختبِر موقعك الإلكتروني على أحدث إصدار من متصفّح متوافق. لإجراء ذلك، افتح أدوات المطوّرين في المتصفّح للاطّلاع على رسائل وحدة التحكّم المرتبطة بموقعك الإلكتروني. تتضمّن الرسائل أخطاءً أو تحذيرات من مكتبة برامج JavaScript الخاصة بواجهة Google Pay API. تتوافق واجهة برمجة التطبيقات Google Pay مع متصفّحات Google Chrome وMozilla Firefox وApple Safari وMicrosoft Edge وOpera وUCWeb UC Browser.

قد تظهر أخطاء إضافية في نافذة مربّع حوار اختيار طريقة الدفع في Google بعد طلب loadPaymentData(). عند النقر على متابعة أو حسنًا بعد الاطّلاع على رسالة الخطأ، قد يعرض تفاصيل إضافية في Promise المرفوضة التي يعالجها موقعك الإلكتروني.

الاختبار على جهاز متوافق

على الرغم من أنّ واجهة برمجة التطبيقات Google Pay API متاحة في العديد من الأسواق، لا تتوفّر البطاقات المميزة إلا في مجموعة فرعية من البلدان. إذا تم ضبط البطاقات التي تم تحويلها إلى رموز مميّزة كطريقة دفع مسموح بها، اختبِرها على جهاز Android يعمل بالإصدار 59 أو الإصدارات الأحدث من Chrome لنظام التشغيل Android والإصدار 16.0.0 أو الإصدارات الأحدث من "خدمات Google Play". إذا كانت طريقة الدفع متوافقة في بلدك ومع المصرف الذي أصدرها، جرِّب استخدام بطاقة محفوظة في تطبيق Google Pay.

لعرض الأخطاء والتحذيرات في وحدة تحكّم Chrome على Android، يمكنك إجراء اختبار باستخدام تصحيح الأخطاء عن بُعد من Chrome على الكمبيوتر. لمزيد من المعلومات حول الأخطاء المحتملة، اطّلِع على السجلّات من جهاز Android. قد تتمكّن من عرض سجلّات الأخطاء باستخدام نافذة أداة Logcat في "استوديو Android" أو باستخدام أداة سطر الأوامر adb logcat أو داخل تقرير خطأ في Android. لعرض رسائل الخطأ ذات الصلة بواجهة برمجة التطبيقات Google Pay API، ابحث عن WalletMerchantError.

في ما يلي عيّنة من الرمز البرمجي:

adb logcat -s WalletMerchantError

اختبار عملية الدمج

قبل إرسال عملية الدمج إلى Google للتحقّق من صحتها باستخدام PaymentsClient تم إعداده لبيئة TEST، تأكَّد من استيفاء معايير الخروج لكل من عمليات التحقّق الوظيفية وعمليات التحقّق من العلامة التجارية التالية.

1. الأساسيات
تأكَّد من أنّ عمليات التحقّق من المخاطر وعناصر التحكّم الحالية الخاصة بمعاملات البطاقة أو رقم الحساب الأساسي تنطبق أيضًا على معاملات Google Pay. لا تهدف عمليات التحقّق من صحة المعلومات وعمليات التحقّق من الاحتيال في Google Pay إلى استبدال عمليات إدارة المخاطر.
إذا كنت تستخدم ميزة 3D Secure بشكل انتقائي (المصادقة الإضافية) لمعاملات البطاقات العادية استنادًا إلى معايير المخاطر، احرص على استخدام معايير المخاطر نفسها لتفعيل ميزة 3D Secure لمعاملات أرقام حسابات Google Pay PAN_ONLY.
تأكَّد من أنّك قرأت بنود الخدمة وأنّك مستعد لقبولها. يتطلّب التسجيل في Google Pay API أن يكون عنوان بريدك الإلكتروني مرتبطًا بحساب Google، ويُفضّل أن يكون عنوان بريد إلكتروني خاصًا بالنشاط التجاري ومرتبطًا بنطاق نشاطك التجاري، مثل "admin@myownpersonaldomain.com". انقر على استخدام عنوان بريدي الإلكتروني الحالي بدلاً من ذلك في مسار إنشاء حساب Google لربط عنوان بريدك الإلكتروني بحساب Google.
استخدام البيانات التي يتم تلقّيها من Google Pay API لمعالجة المعاملات فقط تتطلّب جميع حالات الاستخدام الأخرى موافقة صريحة ومنفصلة من المستخدم.
تأكَّد من شبكات البطاقات وطرق المصادقة على البطاقات التي تقبلها الجهة المسؤولة عن معالجة المعاملات في بلدك.
في حال إكمال عملية دمج DIRECT tokenizationSpecification type، عليك تغيير مفتاح التشفير العلني سنويًا وتقديم شهادة PCI إلى Google باستخدام Google Pay & Wallet Console. يمكن تقديم شهادة الامتثال الخاصة بمعيار أمان بيانات قطاع بطاقات الدفع (PCI) من خلال جهة خارجية أو مقيّم أمان مؤهّل معتمَد من مجلس الحماية المعيارية للبيانات في قطاع بطاقات الدفع، وموافق عليه من قِبل مورّد معتمَد أو مقيّم مؤهّل.

2. اختبارات العلامة التجارية
استخدِم مواد العرض التي تمت الموافقة عليها والتزِم بجميع عناصر إرشادات العلامة التجارية.
تأكَّد من أنّ زر الدفع Google Pay لا يظهر إلا بعد أن يؤكّد موقعك الإلكتروني قدرة المستخدم على الدفع من خلال الدالة isReadyToPay().
تأكَّد من أنّ أبعاد زر الدفع Google Pay المعروض تتطابق مع أبعاد الأزرار والعناصر المشابهة على الصفحة.
اختَر زرًا مناسبًا استنادًا إلى لون خلفية المنطقة التي يظهر فيها.

3- الاختبارات الوظيفية
تأكَّد من أنّه يتم استدعاء loadPaymentData() بشكل متزامن عند النقر على زر الدفع Google Pay، وأنّه يحافظ على سلوك تفعيل المستخدم في المتصفّح الذي يسمح لواجهة برمجة تطبيقات Google Pay بعرض ورقة الدفع. تأكَّد من أنّ ورقة الدفع في Google Pay غير محظورة بواسطة أدوات حظر النوافذ المنبثقة.

عند طلب نوع طريقة الدفع CARD مع مصادقة بطاقة PAN_ONLY، أكمِل الخطوات التالية لإجراء اختبار البطاقات المحفوظة:

  1. إذا كان ذلك منطبقًا، أزِل جميع البطاقات المحفوظة من pay.google.com.
  2. ارجع إلى عملية الدمج.
  3. انقر على Google Pay.
  4. تأكَّد من ظهور خيار إضافة بطاقة.
  5. أضِف بطاقة من شبكة متوافقة، كما هو موضّح في parameters.allowedCardNetworks.
  6. تأكَّد من ظهور البطاقة المُضافة مع شعار الشبكة في أداة الاختيار.

لا ينطبق الاختبار التالي إلا على متصفّح Chrome على أجهزة Android.

عند طلب نوع طريقة الدفع CARD مع مصادقة البطاقة CRYPTOGRAM_3DS، أكمِل الخطوات التالية لإجراء اختبار الرمز المميّز لجهاز Android:

  1. تأكَّد من أنّ جهة إصدار بطاقتك متوافقة، وأضِف بطاقة مؤهَّلة في تطبيق Google Pay على Android.
  2. ارجع إلى عملية الدمج.
  3. انقر على زر الدفع Google Pay.
  4. تأكَّد من ظهور البطاقة المُضافة، مع تصميم البطاقة، في أداة الاختيار.

إذا أكّدت أنّ معالج الدفع يتيح إثبات ملكية البطاقة باستخدام 3D-Secure، يمكنك المتابعة حتى إذا لم يتوفّر لك رمز مميّز لجهاز Android بصفتك مستخدمًا لنظام Android أو صاحب بطاقة.

إذا كنت بحاجة إلى عنوان شحن، اختبِر معالجة عنوان الشحن في حالات إكمال مختلفة، مثل ما يلي:

  • اختلافات في الاسم الكامل سيتم تحليلها إلى حقول منظَّمة، مثل "أحمد" و"أحمد علي" و "سارة أحمد علي"
  • تحليل جميع أسطر العناوين التي تعرضها Google Pay API بدقة، والتي قد تتجاوز إجمالي عدد أسطر العناوين التي يتم جمعها عادةً في مسار الدفع العادي
  • تأكَّد من أنّ عنصر البلد الذي تم عرضه في العنوان يطابق وجهات الشحن المتاحة في موقعك الإلكتروني. إذا حدّدت قيودًا على الشحن، اختبِرها من خلال إدخال عنوان شحن غير مسموح به في ورقة الدفع، وتحقّق مما إذا كانت القيود تعمل.

إذا كنت قد أتحت استخدام ميزة "تفويض الدفعات"، يُرجى التأكّد ممّا يلي:

  • عندما يتعذّر إثبات صحة عملية الدفع، يتم عرض ERROR transactionState و PaymentDataError مع الغرض PAYMENT_AUTHORIZATION.

إذا كنت قد أتحت ميزة "تعديلات الأسعار الديناميكية"، أكمِل الخطوات التالية:

  1. أضِف بطاقة وتفاصيل العنوان في ورقة الدفع.
  2. عدِّل خيارات الشحن وقائمة الطلبات والسعر الإجمالي.
    3. ملاحظة مهمة: تأكَّد من أنّ السعر الإجمالي يطابق مبلغ المعاملة. وفي حال عدم توفّرها، يمكن أن يؤثّر ذلك في قيمة مؤشر التجارة الإلكترونية والجهة المسؤولة.
  3. أضِف عنوان شحن واختَره.
  4. عدِّل خيارات الشحن وقائمة الطلبات والسعر الإجمالي.
  5. حدِّد خيار شحن.
  6. عدِّل قائمة الطلبات وإجمالي السعر.
  7. التحقّق من صحة النتائج:
    • إذا لم يتضمّن عنوان الشحن خيارات شحن متاحة، تأكَّد من أنّك تتلقّى PaymentDataError باستخدام الغرض SHIPPING_ADDRESS.
    • إذا كان خيار الشحن المحدّد غير صالح، تأكَّد من أنّك تتلقّى PaymentDataError مع الغرض SHIPPING_OPTION.
    • في حال تعذُّر مصادقة الدفع، تأكَّد من حصولك على ERROR transactionState و PaymentDataError باستخدام الغرض PAYMENT_AUTHORIZATION.
إذا كنت بحاجة إلى رقم هاتف، اطلبه من عنوان الفوترة. بعد ذلك، اختبِر ما إذا كان بإمكانك تحليل رقم الهاتف وتخزينه وفقًا لمعايير البيانات في موقعك الإلكتروني باستخدام تنسيقات مختلفة، مثل "8005550100+" و"18005550100" و "555-0100 (800)".
تأكَّد من عرض Google Pay بشكل مماثل لطرق الدفع الأخرى التابعة لجهات خارجية.
بالنسبة إلى المستخدمين الذين سبق لهم اختيار Google Pay عند الدفع والإشارة إلى أنّهم يفضّلون استخدام Google Pay كطريقة دفع على موقعك الإلكتروني، يجب ضبط Google Pay تلقائيًا كطريقة دفع لعملية الشراء اللاحقة.
يجب عرض السعر النهائي للمستخدم قبل معالجة المعاملة. إذا كان المبلغ المطلوب تحصيله قد تغيّر استنادًا إلى البيانات التي تم تلقّيها من Google Pay API، من المتوقّع أن تعرض صفحة تأكيد تتضمّن السعر النهائي.