במאמר הזה מוסבר איך להשתמש בשיטות של לקוח JavaScript כדי להטמיע את Google Pay API באפליקציות האינטרנט שלכם.
יצרן
מאתחל את האובייקט PaymentsClient. צריך להפעיל את ה-constructor הזה לפני שמפעילים את ה-methods של החברים.
new PaymentsClient(paymentOptions)
ארגומנטים
| נכס | תיאור |
|---|---|
paymentOptions |
אובייקט שמכיל צמדי מפתח/ערך של נתוני ההגדרות האישיות של Google Pay API. במאמר לדוגמה: |
החזרות
| סוג | תיאור |
|---|---|
google.payments.api.PaymentsClient |
אובייקט PaymentsClient. |
מקפיצה את הודעות השגיאה (Throws)
| סוג | תיאור |
|---|---|
Error
|
ערך מאפיין הסביבה שהועבר לא נתמך. |
Methods של אובייקטים
createButton(options)
השיטה הנוחה משמשת ליצירת כפתור תשלום של Google Pay, שמעוצב לפי המיתוג העדכני של Google Pay, כדי להוסיף אותו לדף אינטרנט.
ה-HTMLElement שנוצר כולל CSS שנוסף באופן דינמי ותמונת SVG שמתארחת ב-CDN של Google.
בספר המותג שלנו מוסבר איך לבחור את סוג הלחצן והצבע המתאימים לעיצוב של האתר. יכול להיות שתצטרכו לשנות את המידות של הכפתור כדי שיתאים לכפתורים דומים או לרכיבי תשלום בדף. אפשר להשתמש בכלי Customize your button כדי להגדיר לחצן לתרחיש לדוגמה.
ארגומנטים
| שם | תיאור |
|---|---|
options |
אובייקט שמכיל צמדי מפתח/ערך להגדרת לחצן.
במאמר לדוגמה: |
החזרות
| סוג | תיאור |
|---|---|
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: אובייקט שמכיל מידע על היכולת של המשתמש לשלם. מידע נוסף זמין במאמר Rejected: אובייקט שגיאה שמכיל מידע נוסף על הסיבה לדחייה. מידע נוסף זמין במאמר |
שגיאות
| statusCode | תיאור |
|---|---|
DEVELOPER_ERROR |
|
loadPaymentData(paymentDataRequest)
השיטה הזו מציגה גיליון תשלום של Google Pay שמאפשר לבחור אמצעי תשלום ופרמטרים שהוגדרו באופן אופציונלי.
צריך להפעיל את השיטה הזו בזמן שהדפדפן מעבד התנהגות הפעלה כתוצאה מאירוע מסוג קליק. יכול להיות שיוצג למשתמש חלון קופץ שבו הוא יוכל לבחור אמצעי תשלום או נתונים נדרשים אחרים שצוינו בפרמטר של הבקשה שהועברה.
ארגומנטים
| שם | תיאור |
|---|---|
paymentDataRequest |
אובייקט שמכיל צמדי מפתח/ערך של הגדרת Google Pay API מלאה.
במאמר PaymentDataRequest מפורטים המאפיינים שאפשר להגדיר. |
החזרות
| סוג | תיאור |
|---|---|
Promise |
Resolved: אובייקט שמכיל את נתוני הקונה המבוקשים. מידע נוסף זמין במאמר PaymentData. Rejected: אובייקט שמכיל קוד שגיאה ומידע נוסף על הסיבה לדחייה. מידע נוסף זמין במאמר PaymentsError. |
שגיאות
| statusCode | תיאור |
|---|---|
CANCELED |
|
DEVELOPER_ERROR |
האובייקט PaymentDataRequest שהועבר לא היה בפורמט הנכון, חסרים בו הפרמטרים המינימליים הנדרשים או שהוא מכיל פרמטר או ערך לא תקינים. |
prefetchPaymentData(paymentDataRequest)
משתמשים בשיטה הזו כדי לאחזר מראש הגדרות של PaymentDataRequest, וכך לשפר את זמן הביצוע של loadPaymentData באינטראקציה הבאה של המשתמש. לא מוחזר ערך.
אופטימיזציות של אחזור מראש זמינות ב-Chrome ל-Android.
ארגומנטים
| שם | תיאור |
|---|---|
paymentDataRequest |
אובייקט שמכיל צמדי מפתח/ערך של הגדרת Google Pay API מלאה.
במאמר PaymentDataRequest מפורטים המאפיינים שאפשר להגדיר. שינוי במאפיין transactionInfo לא משפיע על ערך האחזור מראש שנשמר במטמון. |
קריאות חוזרות (callbacks) של נתוני תשלום
אפשר להעביר את גורמים מטפלים בקריאה חוזרת הבאים אל PaymentOptions.paymentDataCallbacks כדי לתמוך באישור תשלומים ובעדכוני מחירים דינמיים.
onPaymentAuthorized(paymentData)
השיטה הזו נקראת כשתשלום מאושר בגיליון התשלום.
ארגומנטים
| שם | תיאור |
|---|---|
paymentData |
אובייקט שמכיל את נתוני הקונה המבוקשים. פרטים נוספים זמינים במאמר PaymentData. |
החזרות
| סוג | תיאור |
|---|---|
Promise |
Resolved: אובייקט שמכיל מידע על תוצאות של עסקאות תשלום.
פרטים נוספים זמינים במאמר נדחתה: אובייקט שגיאה עם כוונה והודעת שגיאה שיוצגו בגיליון התשלום. מידע נוסף מופיע במאמר |
onPaymentDataChanged(intermediatePaymentData)
השיטה הזו מטפלת בשינויים בנתוני התשלום בגיליון התשלום, כמו כתובת למשלוח ואפשרויות משלוח.
ארגומנטים
שלום| שם | תיאור |
|---|---|
intermediatePaymentData |
אובייקט שמכיל את הכתובת ואת אפשרות המשלוח שנבחרו בגיליון התשלום. פרטים נוספים זמינים במאמר IntermediatePaymentData. |
החזרות
| סוג | תיאור |
|---|---|
Promise |
Resolved: אובייקט שמכיל מידע על פרטי עסקה חדשים, אפשרויות משלוח ושגיאות בנתוני תשלום. פרטים נוספים זמינים במאמר נדחתה: אובייקט שגיאה עם כוונה והודעת שגיאה שיוצגו בגיליון התשלום. מידע נוסף מופיע במאמר |