אחרי שיוצרים כרטיס ומקודדים אותו ב-JWT חתום, אפשר להנפיק אותו בכל מקום שבו יש תמיכה בקישור "הוספה ל-Google Wallet". כדי לעשות את זה, אתם צריכים להציג למשתמשים לחצן "הוספה ל-Google Wallet" או היפר-קישור. כשהם ילחצו עליו, הכרטיס יישמר ב-Google Wallet שלהם. דוגמאות למקומות שבהם אפשר להשתמש בשיטה הזו: אפליקציות לנייד, אתרים, אימייל, צ'אט ו-SMS.
דרישות מוקדמות
לפני שמנסים להנפיק כרטיס, חשוב לבצע את הפעולות הבאות:
- מבצעים את כל השלבים שמפורטים במדריך לתחילת העבודה.
- יוצרים לפחות מחלקה אחת של כרטיסים.
- יוצרים לפחות אובייקט כרטיס אחד.
- מקודדים את מחלקת הכרטיסים ואת אובייקט הכרטיסים ב-JWT.
- חותמים על ה-JWT באמצעות המפתח של חשבון השירות ב-Google Cloud.
1. יצירת קישור "הוספה ל-Google Wallet"
הנפקת כרטיס עם קישור ל-Google Wallet מוסיפה את אובייקט הכרטיסים ל-Google Wallet של המשתמש, ואפשר להפעיל אותה רק בהקשר של זהות Google מחוברת.
הקישור "הוספה ל-Google Wallet" הוא כתובת URL שנוצרת באופן דינמי ומכילה אסימון אינטרנט מסוג JSON (JWT) מקודד וחתום.
הקישור "הוספה ל-Google Wallet" הוא בפורמט הבא:
https://pay.google.com/gp/v/save/<signed_jwt>
לדוגמה, קישור מלא של "הוספה ל-Google Wallet" ייראה כך:
https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A
אפשר להטמיע את הקישור הזה באפליקציות לנייד, באתרים, באימייל, בצ'אט, ב-SMS או בכל מקום אחר שתומך בהיפר-קישורים.
מידע נוסף על יצירת מחלקות של כרטיסים ואובייקטים של כרטיסים זמין במאמר יצירת מחלקות של כרטיסים ואובייקטים של כרטיסים.
כדי לקבל מידע נוסף על יצירת ה-JWT החתום שנדרש ליצירת קישור "הוספה ל-Google Wallet", אפשר לעיין במאמר עבודה עם אסימוני אינטרנט מסוג JSON.
2. (מומלץ) שימוש בכפתור "הוספה ל-Google Wallet"
בכל פלטפורמה שתומכת בהיפר-קישור לתמונות, כמו אתרים ואימייל, מומלץ להציג למשתמשים את הקישור "הוספה ל-Google Wallet" באמצעות כפתור "הוספה ל-Google Wallet". למשתמשי Google Wallet, הלחצן הוא הנחיה מוכרת שניתן לזהות כדרך להוסיף כרטיס ל-Google Wallet.
נכסי תמונות זמינים להורדה במגוון כיוונים ושפות כדי לתמוך בשילוב של Google Wallet API.