עדכון ההתנהגות של אירועי CanMakePayment ב-Payment Handler API

Eiji Kitamura

Payment Handler API מאפשר לספקי תשלום להציע למוכרים אפשרות לשלם בהתאמה אישית עם ממשק Payment Request API. כשPayment Request API מופעל באמצעות המבנה new PaymentRequest(), הוא מפעיל ללא התראה אירוע canmakepayment עם המקור של המוכר ונתונים שרירותיים, לסוכנות שירות שרשומה ל-Payment Handler API. התקשורת בין מקורות לא מחייבת תנועת משתמש ולא מוצג בה ממשק משתמש.

Chrome יוציא את השדות המזהים מהאירוע canmakepayment ויתחיל את תקופת הניסיון של גרסת המקור מ-Chrome 108.

המידע בדף הזה רלוונטי רק לספקי אפליקציות התשלום שמשתמשים ב-Payment Handler API. אם אתם לא משתמשים בו, אתם יכולים לדלג על ההוראות האלה.

מה משתנה?

כשמוכר קורא ל-new PaymentRequest(), אירוע canmakepayment (CanMakePaymentEvent) מגיע ל-service worker רשום, ומכיל את הפרטים הבאים:

• topOrigin
• paymentRequestOrigin
• methodData
• modifiers

הם יוסרו, ועובד השירות יקבל פשוט את האירוע canmakepayment ללא מידע נוסף.

זיהוי תכונות

כדי לבדוק אם האירוע canmakepayment השתנה בקוד של ה-service worker, בודקים את המאפיינים המתאימים באופן הבא:

self.addEventListener(e => {
  if (e.paymentRequestOrigin) {...}
  if (e.topOrigin) {...}
  if (e.methodData && e.methodData.length > 0) {...}
  if (e.modifiers && e.modifiers.length > 0) {...}
  ...
});

כדאי לנסות את השינוי באופן מקומי

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

1. משתמשים ב-Chrome בגרסה 108,‏ 109 או 110.
2. מזינים chrome://flags/#clear-identity-in-can-make-payment בסרגל כתובות ה-URL.
3. מפעילים את הדגל.
4. מפעילים מחדש את Chrome.

הפעלת הדגל תמחק את שדות הזהות באירוע canmakepayment (וגם את ה-Intent‏ IS_READY_TO_PAY של Android).

הפעלת השינוי בסביבת הייצור

אפשר גם להפעיל את השינוי בסביבת הייצור למטרות בדיקה לפני שהוא מגיע ל-Chrome. המנגנון הזה נקרא גרסת מקור לניסיון.

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

כדי להירשם לתקופת ניסיון למקור:

1. מבקשים אסימון למקור.
2. מוסיפים את האסימון לקובץ JavaScript של ה-service worker באמצעות כותרת HTTP‏ Origin-Trial. כדי להגדיר כותרות HTTP, נדרשת גישה להגדרת השרת. כותרת התגובה שמתקבלת אמורה להיראות בערך כך:

Origin-Trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...

כדי לראות את אסימון הניסיון למקור בקובץ של ה-service worker, אפשר להשתמש בכלי הפיתוח או בפקודה curl באופן הבא:

$ curl --head <Service Worker JS file URL> | grep -i origin-trial
origin-trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...

הפעלה מחדש של שדות הזהות באופן מקומי אחרי Chrome 111

אם אתם משתמשים ב-Chrome 111 ואילך, שדות הזהות באירוע canmakepayment יישארו ריקים. כדי להפעיל מחדש את השדות באופן מקומי, אפשר לבצע את הפעולות הבאות:

1. צריך להשתמש ב-Chrome בגרסה 111 ואילך.
2. מזינים chrome://flags/#add-identity-in-can-make-payment בסרגל של כתובות ה-URL.
3. מפעילים את הדגל.
4. מפעילים מחדש את Chrome.

השלבים הבאים

אנחנו מתכננים להפעיל את השינוי הזה כברירת מחדל בגרסת Chrome 111. אתם יכולים להתחיל לבדוק את הנושא כבר היום כדי להתכונן לשינוי במועד ההשקה.