بعد إنشاء بطاقة وترميزها في مستند JWT موقَّع، تصبح جاهزًا لإصدارها في أي مكان يتيح فيه رابط "الإضافة إلى محفظة Google". لإجراء ذلك، يجب تزويد المستخدم بزر "الإضافة إلى "محفظة Google" أو رابط تشعّبي لحفظ البطاقة في "محفظة Google" عند النقر عليها. تشمل الأمثلة على الأماكن التي يمكنك استخدام هذه الطريقة فيها المواقع الإلكترونية، والبريد الإلكتروني، والرسائل القصيرة، وغيرها.
المتطلبات الأساسية
قبل محاولة إصدار بطاقة، تأكَّد من إجراء ما يلي:
- أكمِل جميع الخطوات الواردة في دليل الإعداد.
- أنشئ فئة بطاقات واحدة على الأقل.
- أنشئ عنصر بطاقات واحدًا على الأقل.
- ترميز فئة البطاقات وعنصر البطاقات في JWT
- وقِّع جهاز JWT باستخدام مفتاح حساب خدمة Google Cloud.
1- إنشاء رابط "الإضافة إلى محفظة Google"
يؤدي إصدار بطاقة باستخدام رابط "محفظة Google" إلى إضافة عنصر "البطاقات" إلى "محفظة Google" لدى المستخدم، ولا يمكن تقديم هذا العنصر إلا في سياق هوية Google التي تم تسجيل الدخول إليها.
إنّ رابط "الإضافة إلى محفظة Google" هو عنوان URL يتم إنشاؤه ديناميكيًا ويحتوي على رمز JSON مميّز للويب (JWT) مرمّز وموقَّع.
يكون الرابط "إضافة إلى محفظة Google" بالتنسيق التالي:
https://pay.google.com/gp/v/save/<signed_jwt>
على سبيل المثال، سيبدو رابط "الإضافة إلى محفظة Google" المكتمل بالكامل على النحو التالي:
https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A
يمكن تضمين هذا الرابط في مواقع الويب أو البريد الإلكتروني أو الدردشة أو الرسائل القصيرة أو أي مكان آخر يدعم الروابط التشعبية.
لمزيد من المعلومات حول إنشاء فئات البطاقات وعناصر البطاقات، يُرجى الاطّلاع على المقالة إنشاء فئات البطاقات وعناصر البطاقات.
لمزيد من المعلومات حول كيفية إنشاء رمز JWT الموقَّع والمطلوب لإنشاء رابط "الإضافة إلى محفظة Google"، يُرجى الاطّلاع على مقالة العمل باستخدام رموز الويب المميّزة JSON.
2. (يُنصح به) استخدام زر "الإضافة إلى محفظة Google"
على أي مساحات عرض تتوافق مع الصور التي تتضمّن روابط تشعّبية، مثل المواقع الإلكترونية والبريد الإلكتروني، ننصحك بتقديم الرابط "إضافة إلى "محفظة Google" للمستخدمين باستخدام زر "الإضافة إلى "محفظة Google". بالنسبة إلى مستخدمي "محفظة Google"، الزر هو عبارة عن طلب مألوف يمكن التعرّف عليه كطريقة لبدء إضافة بطاقة إلى "محفظة Google".
تتوفّر مواد عرض الصور لتنزيلها باتّجاهات ولغات مختلفة لتعزيز عملية دمج Google Wallet API.