הפניה ללקוח

במאמר הזה מוסבר איך להשתמש בשיטות של לקוח JavaScript כדי להטמיע את Google Pay API באפליקציות האינטרנט שלכם.

יצרן

מאתחל את האובייקט PaymentsClient. צריך להפעיל את ה-constructor הזה לפני שמפעילים את ה-methods של החברים.

new PaymentsClient(paymentOptions)‎

ארגומנטים

נכס תיאור
paymentOptions

אובייקט שמכיל צמדי מפתח/ערך של נתוני ההגדרות האישיות של Google Pay API. במאמר PaymentOptions מפורטים המאפיינים השונים שאפשר להגדיר.

לדוגמה: {environment:'PRODUCTION'}

החזרות

סוג תיאור
google.payments.api.PaymentsClient אובייקט PaymentsClient.

מקפיצה את הודעות השגיאה (Throws)

סוג תיאור
Error

ערך מאפיין הסביבה שהועבר לא נתמך.

‫Methods של אובייקטים

createButton(options)

השיטה הנוחה משמשת ליצירת כפתור תשלום של Google Pay, שמעוצב לפי המיתוג העדכני של Google Pay, כדי להוסיף אותו לדף אינטרנט.

ה-HTMLElement שנוצר כולל CSS שנוסף באופן דינמי ותמונת SVG שמתארחת ב-CDN של Google.

בספר המותג שלנו מוסבר איך לבחור את סוג הלחצן והצבע המתאימים לעיצוב של האתר. יכול להיות שתצטרכו לשנות את המידות של הכפתור כדי שיתאים לכפתורים דומים או לרכיבי תשלום בדף. אפשר להשתמש בכלי Customize your button כדי להגדיר לחצן לתרחיש לדוגמה.

ארגומנטים

שם תיאור
options

אובייקט שמכיל צמדי מפתח/ערך להגדרת לחצן. במאמר ButtonOptions מפורטים המאפיינים שאפשר להגדיר.

לדוגמה: {onClick:onGooglePaymentButtonClicked}

החזרות

סוג תיאור
HTMLElement רכיב <button> ב-HTML בתוך מאגר תוכן כללי של זרימה, כמו <div>.

מקפיצה את הודעות השגיאה (Throws)

סוג תיאור
Error

לא הוגדר מאפיין חובה.

isReadyToPay(isReadyToPayRequest)

משתמשים ב-method‏ isReadyToPay(isReadyToPayRequest) כדי לקבוע אם המשתמש יכול להחזיר אמצעי תשלום מ-Google Pay API.

אם הדפדפן תומך ב-Google Pay, הפונקציה isReadyToPay מחזירה את הערך true. כדי לקבוע אם המשתמש מחובר לחשבון Google או שכבר שמר אמצעי תשלום ב-Google Pay, מגדירים את IsReadyToPayRequest.existingPaymentMethodRequired לערך true ומוודאים שהפונקציה paymentMethodPresent מחזירה את הערך true ב-resolved promise. פרטים נוספים זמינים במאמר IsReadyToPayResponse.

אם PaymentsClient אותחל עם מאפיין סביבה של TEST, הפונקציה paymentMethodPresent תמיד מחזירה את הערך true.

ארגומנטים

שם תיאור
isReadyToPayRequest אובייקט שמכיל את אמצעי התשלום שהמוכר מקבל. לפרטים על המאפיינים השונים שאפשר להגדיר, ראו IsReadyToPayRequest.

החזרות

סוג תיאור
Promise

Resolved: אובייקט שמכיל מידע על היכולת של המשתמש לשלם. מידע נוסף זמין במאמר IsReadyToPayResponse.

‫Rejected: אובייקט שגיאה שמכיל מידע נוסף על הסיבה לדחייה. מידע נוסף זמין במאמר PaymentsError.

שגיאות

statusCode תיאור
DEVELOPER_ERROR
  • האובייקט IsReadyToPayRequest שהועבר לא היה בפורמט הנכון, לא כלל את הפרמטרים המינימליים שנדרשים כדי לקבוע אם המשתמש מוכן לשלם, או שהוא מכיל פרמטר או ערך לא תקינים.
  • הבקשה בוצעה מהקשר אבטחה שסוכן התשלומים או הדפדפן בחרו לא למלא. בדרך כלל, זו שגיאה של הקשר דפדפן לא מאובטח.

loadPaymentData(paymentDataRequest)

השיטה הזו מציגה גיליון תשלום של Google Pay שמאפשר לבחור אמצעי תשלום ופרמטרים שהוגדרו באופן אופציונלי.

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

ארגומנטים

שם תיאור
paymentDataRequest אובייקט שמכיל צמדי מפתח/ערך של הגדרת Google Pay API מלאה. במאמר PaymentDataRequest מפורטים המאפיינים שאפשר להגדיר.

החזרות

סוג תיאור
Promise

Resolved: אובייקט שמכיל את נתוני הקונה המבוקשים. מידע נוסף זמין במאמר PaymentData.

‫Rejected: אובייקט שמכיל קוד שגיאה ומידע נוסף על הסיבה לדחייה. מידע נוסף זמין במאמר PaymentsError.

שגיאות

statusCode תיאור
CANCELED
  • אין תמיכה בדפדפן הנוכחי או במשתמש שמחובר לחשבון Google.
  • הקונה סגר את גיליון התשלום של Google Pay בלי לאשר את התשלום.
  • הבקשה בוצעה מהקשר אבטחה שסוכן התשלומים או הדפדפן בחרו לא למלא. בדרך כלל, הקשר לא מאובטח של הדפדפן.
  • השיטה הופעלה כשגיליון התשלום של Google Pay כבר הוצג.
  • האובייקט PaymentDataRequest שהועבר נדחה על ידי גיליון התשלומים של Google Pay. סיבה נפוצה היא פרמטרים של PaymentMethodTokenizationSpecification חסרים או חלקיים בשער התשלומים, או ערכי פרמטרים לא תקינים.
DEVELOPER_ERROR האובייקט PaymentDataRequest שהועבר לא היה בפורמט הנכון, חסרים בו הפרמטרים המינימליים הנדרשים או שהוא מכיל פרמטר או ערך לא תקינים.

prefetchPaymentData(paymentDataRequest)

משתמשים בשיטה הזו כדי לאחזר מראש הגדרות של PaymentDataRequest, וכך לשפר את זמן הביצוע של loadPaymentData באינטראקציה הבאה של המשתמש. לא מוחזר ערך.

אופטימיזציות של אחזור מראש זמינות ב-Chrome ל-Android.

ארגומנטים

שם תיאור
paymentDataRequest אובייקט שמכיל צמדי מפתח/ערך של הגדרת Google Pay API מלאה. במאמר PaymentDataRequest מפורטים המאפיינים שאפשר להגדיר. שינוי במאפיין transactionInfo לא משפיע על ערך האחזור מראש שנשמר במטמון.

קריאות חוזרות (callbacks) של נתוני תשלום

אפשר להעביר את גורמים מטפלים בקריאה חוזרת הבאים אל PaymentOptions.paymentDataCallbacks כדי לתמוך באישור תשלומים ובעדכוני מחירים דינמיים.

onPaymentAuthorized(paymentData)

השיטה הזו נקראת כשתשלום מאושר בגיליון התשלום.

ארגומנטים

שם תיאור
paymentData אובייקט שמכיל את נתוני הקונה המבוקשים. פרטים נוספים זמינים במאמר PaymentData.

החזרות

סוג תיאור
Promise

Resolved: אובייקט שמכיל מידע על תוצאות של עסקאות תשלום. פרטים נוספים זמינים במאמר PaymentAuthorizationResult.

נדחתה: אובייקט שגיאה עם כוונה והודעת שגיאה שיוצגו בגיליון התשלום. מידע נוסף מופיע במאמר PaymentDataError.

onPaymentDataChanged(intermediatePaymentData)

השיטה הזו מטפלת בשינויים בנתוני התשלום בגיליון התשלום, כמו כתובת למשלוח ואפשרויות משלוח.

ארגומנטים

שלום
שם תיאור
intermediatePaymentData אובייקט שמכיל את הכתובת ואת אפשרות המשלוח שנבחרו בגיליון התשלום. פרטים נוספים זמינים במאמר IntermediatePaymentData.

החזרות

סוג תיאור
Promise

‫Resolved: אובייקט שמכיל מידע על פרטי עסקה חדשים, אפשרויות משלוח ושגיאות בנתוני תשלום. פרטים נוספים זמינים במאמר PaymentDataRequestUpdate.

נדחתה: אובייקט שגיאה עם כוונה והודעת שגיאה שיוצגו בגיליון התשלום. מידע נוסף מופיע במאמר PaymentDataError.