بعد إنشاء بطاقة وترميزها في رمز JWT موقَّع، يمكنك إصدارها في أي مكان يتوافق مع رابط "الإضافة إلى محفظة Google". لإجراء ذلك، عليك عرض زر "الإضافة إلى محفظة Google" أو رابط تشعّبي للمستخدم، ما سيؤدي إلى حفظ البطاقة في "محفظة Google" بعد النقر عليه. تشمل الأمثلة على الحالات التي يمكنك فيها استخدام هذه الطريقة التطبيقات على الأجهزة الجوّالة والمواقع الإلكترونية والبريد الإلكتروني والمحادثة والرسائل القصيرة.
المتطلبات الأساسية
قبل محاولة إصدار بطاقة، تأكَّد من تنفيذ ما يلي:
- أكمِل جميع الخطوات الواردة في دليل الإعداد.
- أنشِئ صف بطاقات واحدًا على الأقل.
- أنشِئ عنصر بطاقات واحدًا على الأقل.
- ترميز "صنف البطاقات" و"عنصر البطاقات" في رمز JWT
- وقِّع على رمز JWT باستخدام مفتاح حساب الخدمة في Google Cloud.
1. إنشاء رابط "الإضافة إلى محفظة Google"
يؤدي إصدار بطاقة باستخدام رابط "محفظة Google" إلى إضافة عنصر البطاقات إلى "محفظة Google" الخاصة بالمستخدم، ولا يمكن بدء هذه العملية إلا في سياق Google Identity التي تم تسجيل الدخول إليها.
رابط "الإضافة إلى محفظة 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.