רשימת משימות לשילוב

כדי לוודא שהשלמתם את כל השלבים הנדרשים בשילוב עם האתר, תוכלו להיעזר ברשימת המשימות הבאה.

מידע על סביבת הבדיקה

הגדרת בדיקה של Google Pay API לא מחזירה פרטי תשלום פעילים שניתן לחייב, אלא מאפשרת לבדוק רכיבים בתהליך הרכישה. אלה הרכיבים שאפשר לבדוק:

  • דפי אישור
  • קבלות
  • כתובת לחיוב (אופציונלי)
  • מספר טלפון לחיוב (אופציונלי)
  • הכתובת למשלוח (אופציונלי)
  • כתובת אימייל (אופציונלי)

כדי להשתמש בסביבת בדיקה עם תגובה לדוגמה של נתוני תשלום, צריך לאתחל PaymentsClient חדש עם אובייקט JavaScript שמכיל מאפיין סביבה שהערך שלו הוא TEST.

דוגמת קוד: 
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

בדיקה באמצעות ה-Developer Console בדפדפן

בודקים את האתר בגרסה העדכנית של דפדפן נתמך. כדי לעשות את זה, פותחים את כלי הפיתוח בדפדפן כדי לראות את הודעות המסוף שקשורות לאתר. ההודעות כוללות שגיאות או אזהרות מספריית הלקוח של Google Pay API JavaScript. ‫Google Pay API תומך בדפדפנים Google Chrome‏, Mozilla Firefox‏, Apple Safari‏, Microsoft Edge‏, Opera ו-UCWeb UC Browser.

יכול להיות שיוצגו שגיאות נוספות בתיבת הדו-שיח לבחירת אמצעי תשלום של Google אחרי שתתקשרו אל loadPaymentData(). כשלוחצים על המשך או על אישור אחרי שרואים את הודעת השגיאה, יכול להיות שיוצגו פרטים נוספים בבקשת Promise שנדחתה ומטופלת על ידי האתר.

בדיקה במכשיר תואם

‫Google Pay API זמין בשווקים רבים, אבל כרטיסים עם טוקנים זמינים רק בחלק מהמדינות. אם כרטיסים שעברו טוקניזציה מוגדרים כאמצעי תשלום מותר, צריך לבדוק אותם במכשיר Android עם Chrome ל-Android בגרסה 59 ומעלה ועם Google Play Services בגרסה 16.0.0 ומעלה. אם אמצעי התשלום שלכם נתמך במדינה שלכם ועל ידי הבנק המנפיק, כדאי לבדוק את הנושא באמצעות כרטיס ששמור באפליקציית Google Pay.

כדי לראות את האזהרות והשגיאות במסוף של Chrome ל-Android, צריך לבצע בדיקה באמצעות ניפוי באגים מרחוק מ-Chrome למחשב. למידע נוסף על שגיאות אפשריות, אפשר לעיין ביומנים ממכשיר Android. אפשר לצפות ביומני שגיאות באמצעות חלון הכלי Logcat ב-Android Studio, באמצעות כלי שורת הפקודה 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 PAN_ONLY.
חשוב לוודא שקראתם את התנאים וההגבלות שלנו ושהם מקובלים עליכם. כדי להירשם ל-Google Pay API, כתובת האימייל שלכם צריכה להיות משויכת לחשבון Google, ועדיף שזו תהיה כתובת אימייל עסקית שמשויכת לדומיין העסקי שלכם, כמו admin@myownpersonaldomain.com. בוחרים באפשרות אני רוצה להשתמש במקום זאת בכתובת האימייל הנוכחית שלי בתהליך יצירת חשבון Google כדי לשייך את כתובת האימייל לחשבון Google.
להשתמש בנתונים שמתקבלים מ-Google Pay API רק לעיבוד עסקאות. בכל שאר תרחישי השימוש, נדרשת הסכמה מפורשת נפרדת מהמשתמש.
חשוב לוודא שרשתות הכרטיסים ושיטות האימות של הכרטיסים שאתם משתמשים בהם מקובלות על החברה לעיבוד תשלומים במדינה שלכם.
אם משלימים שילוב של DIRECT tokenizationSpecification type, צריך להחליף מדי שנה את מפתח ההצפנה הציבורי ולספק ל-Google אישור תאימות לתקן PCI באמצעות מסוף Google Pay ו-Wallet. הצהרת התאימות ל-PCI יכולה להישלח על ידי צד שלישי או על ידי בוחן אבטחה מוסמך (QSA) שאושר על ידי המועצה לתקני אבטחה של PCI, ואושר על ידי ספק מאושר או בוחן מוסמך.

2. בדיקות מותג
עליך להשתמש בנכסים המאושרים שלנו ולפעול לפי כל ההנחיות שמופיעות בהנחיות המיתוג.
חשוב לוודא שלחצן התשלום של Google Pay מופיע רק אחרי שהאתר מאשר את היכולת של המשתמש לשלם באמצעות הפונקציה isReadyToPay().
מוודאים שהמידות של לחצן התשלום Google Pay שמוצגות תואמות למידות של לחצנים ורכיבים דומים בדף.
בוחרים לחצן מתאים לפי צבע הרקע של האזור שבו הוא מופיע.

3. בדיקות פונקציונליות
מוודאים שהפונקציה loadPaymentData() מופעלת באופן סינכרוני כשלוחצים על לחצן התשלום Google Pay, ושומרת על התנהגות ההפעלה של המשתמש בדפדפן שמאפשרת ל-Google Pay API להציג דף תשלום. מוודאים שגיליון התשלום של 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 או בעלי כרטיס.

אם אתם דורשים כתובת למשלוח, כדאי לבדוק את העיבוד של הכתובת למשלוח במצבים שונים של השלמת הפרטים, למשל:

  • וריאציות של שם מלא שצריך לנתח לשדות מובנים, כמו 'John',‏ 'John Doe' ו-'Jane Doe Smith'.
  • לנתח בצורה מדויקת את כל שורות הכתובת שמוחזרות על ידי Google Pay API, שעשויות לחרוג מהמספר הכולל של שורות הכתובת שנאספות בדרך כלל בתהליך התשלום הרגיל שלכם.
  • בודקים שרכיב המדינה שמוחזר בכתובת תואם ל יעדי המשלוח הנתמכים באתר שלכם. אם הגדרתם הגבלות על משלוחים, כדאי לבדוק אותן: מזינים כתובת משלוח לא נתמכת שאסורה בגיליון התשלומים שלנו ובודקים אם ההגבלות פועלות.

אם הטמעתם תמיכה באישור תשלומים, ודאו את הדברים הבאים:

  • אם אימות התשלום נכשל, מוחזרת ERROR transactionState ו- PaymentDataError עם הכוונה PAYMENT_AUTHORIZATION.

אם הטמעתם תמיכה בעדכוני מחירים דינמיים, צריך לבצע את השלבים הבאים:

  1. מוסיפים כרטיס ופרטי כתובת בגיליון התשלום.
  2. עדכון של אפשרויות המשלוח, רשימת ההזמנות והמחיר הכולל.
    3. חשוב: צריך לוודא שהמחיר הכולל זהה לסכום העסקה. אחרת, זה יכול להשפיע על הערך של מדד המסחר האלקטרוני (ECI) ועל הצד האחראי.
  3. מוסיפים כתובת למשלוח ובוחרים אותה.
  4. עדכון של אפשרויות המשלוח, רשימת ההזמנות והמחיר הכולל.
  5. בוחרים אפשרות משלוח.
  6. מעדכנים את רשימת ההזמנות ואת המחיר הכולל.
  7. אימות התוצאות:
    • אם אין אפשרויות משלוח זמינות לכתובת המשלוח, צריך לוודא שמתקבלת התגובה PaymentDataError עם כוונת המשתמש SHIPPING_ADDRESS.
    • אם אפשרות המשלוח שנבחרה לא תקינה, צריך לוודא שמתקבלת התוצאה PaymentDataError עם כוונת המשתמש SHIPPING_OPTION.
    • אם אימות התשלום נכשל, צריך לוודא שמתקבלים הערכים ERROR transactionState ו- PaymentDataError עם הכוונה PAYMENT_AUTHORIZATION.
אם אתם צריכים מספר טלפון, בקשו אותו מכתובת החיוב. לאחר מכן, בודקים אם אפשר לנתח ולאחסן את מספר הטלפון לפי תקני הנתונים של האתר בפורמטים שונים, כמו ‎+8005550100,‏ ‎18005550100 ו-‎(800) 555-0100.
חשוב לוודא ש-Google Pay מוצג באופן שווה לאמצעי תשלום אחרים של צד שלישי.
אם משתמשים בחרו בעבר ב-Google Pay בקופה וציינו את Google Pay כאמצעי התשלום המועדף שלהם באתר שלכם, Google Pay חייב להיות אמצעי התשלום שמוגדר כברירת מחדל ברכישה הבאה שלהם.
לפני עיבוד העסקה, צריך להציג למשתמש את המחיר הסופי. אם הסכום לחיוב השתנה על סמך נתונים שהתקבלו מ-Google Pay API, עליכם להציג דף אישור עם המחיר הסופי.