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

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

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

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

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

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

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

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

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

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

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

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

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

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

adb logcat -s WalletMerchantError

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

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

1. الأساسيات
تأكَّد من أنّ عمليات التحقّق من المخاطر وعناصر التحكّم الحالية في معاملات البطاقة أو رقم الحساب الأساسي (PAN) يتم تطبيقها أيضًا على معاملات Google Pay. لا تهدف عمليات التحقّق من صحة المعلومات ومنع الاحتيال في Google Pay إلى أن تكون بديلاً عن عمليات إدارة المخاطر.
إذا كنت تفعّل ميزة 3D Secure بشكل انتقائي (المصادقة الإضافية) لمعاملات البطاقات العادية استنادًا إلى معايير المخاطر، احرص على استخدام معايير المخاطر نفسها لتفعيل ميزة 3D Secure لمعاملات PAN_ONLY التي تتم باستخدام رقم الحساب الأساسي (PAN) في Google Pay.
تأكَّد من أنّك قرأت بنود الخدمة وأنّك مستعد لقبولها. يتطلّب التسجيل في 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- الاختبارات الوظيفية
اختبِر عملية الدمج على العديد من متصفّحات الويب الشائعة (مثل Google Chrome وApple Safari وMozilla Firefox وMicrosoft Edge) وأنظمة التشغيل للأجهزة الجوّالة (Android وiOS) للتأكّد من أنّ عرض الأزرار والنوافذ المنبثقة الخاصة بنموذج الدفع وتدفقات المعاملات تعمل بشكل صحيح.
تأكَّد من أنّه يتم استدعاء 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، من المتوقّع أن تعرض صفحة تأكيد تتضمّن السعر النهائي.