تكوين بطاقة Google Wallet لنظام Android

اربط جهة الإصدار الخاصة بك في Google Pay & Wallet Console بـ Pushwoosh حتى يتمكن من إصدار وتحديث بطاقات Google Wallet لتطبيقك. تدعو حساب خدمة Pushwoosh إلى جهة الإصدار الخاصة بك، وتُدخل معرّف المُصدر (Issuer ID) في لوحة التحكم. لا تحتاج إلى مشروع Google Cloud خاص بك أو مفتاح JSON. هذه عملية إعداد لمرة واحدة. بمجرد وجود تكوين صالح، يتم فتح أداة إنشاء البطاقات (pass builder) للتطبيق.

هام

يتم تخزين التكوين لكل تطبيق. قم بتكوينه لكل تطبيق يصدر بطاقات.

إنشاء حساب المُصدر

سجّل للحصول على حساب مُصدر. في Google Pay & Wallet Console، أكمل عملية إعداد Google Wallet API للحصول على معرّف المُصدر (Issuer ID) الخاص بك (قيمة رقمية). يمكنك البدء في الوضع التجريبي وطلب الوصول إلى الإنتاج لاحقًا.

دعوة حساب خدمة Pushwoosh

ينشئ Pushwoosh البطاقات ويحدّثها في جهة الإصدار الخاصة بك عبر حساب الخدمة الخاص به wallet-issuer@pushwoosh-wallet.iam.gserviceaccount.com. يظهر العنوان نفسه في نموذج Google Wallet في لوحة التحكم، وبجانبه زر نسخ.

في Google Pay & Wallet Console:

1. افتح المستخدمون (Users) في الشريط الجانبي الأيسر.
2. انقر على دعوة مستخدم (Invite a user).
3. الصق wallet-issuer@pushwoosh-wallet.iam.gserviceaccount.com.
4. عيّن مستوى الوصول (Access level) إلى مطور (Developer).
5. انقر على دعوة (Invite).

بدون هذه الخطوة، لا يمكن لـ Pushwoosh إنشاء أو تحديث بطاقات Google Wallet.

من يجب أن يملك حق الوصول إلى جهة الإصدار

يجب أن يكون شخص واحد على الأقل في قائمة المستخدمون (Users) لجهة الإصدار مستخدمًا أيضًا في حساب Pushwoosh الخاص بك، بعنوان البريد الإلكتروني نفسه. يتحقق Pushwoosh من ذلك قبل إصدار البطاقات عبر حساب الخدمة الخاص به، حتى لا يتمكن حساب Pushwoosh آخر من الكتابة في جهة الإصدار الخاصة بك بمجرد إدخال معرّف المُصدر الخاص بك.

إذا لم يتطابق أي شخص، فلن يتمكن Pushwoosh من إنشاء البطاقات أو تحديثها في جهة الإصدار. أصلح ذلك بإحدى الطريقتين:

• ادعُ عنوان بريدك الإلكتروني (الذي تسجّل به الدخول إلى Pushwoosh) إلى جهة الإصدار في Google Pay & Wallet Console.
• ادعُ شخصًا لديه بالفعل حق الوصول إلى جهة الإصدار إلى حساب Pushwoosh الخاص بك.

تكوين Google Wallet في لوحة التحكم

1. اذهب إلى الإعدادات → تهيئة المنصات في لوحة التحكم.
2. تحت منصات الهاتف المحمول، ابحث عن Android وافتح إعداد Google Wallet.

3. في معرف جهة الإصدار، أدخل معرّف المُصدر الرقمي من Google Pay & Wallet Console.
4. انقر على تطبيق.

استخدام مفتاح حساب الخدمة الخاص بك (اختياري)

إذا كنت تُصدر البطاقات بالفعل باستخدام حساب خدمة Google Cloud الخاص بك، فيمكنك الاستمرار في استخدامه بدلًا من حساب خدمة Pushwoosh. عندما يكون للتطبيق مفتاح خاص به، يستخدم Pushwoosh هذا المفتاح دائمًا.

1. أنشئ حساب خدمة في مشروع Google Cloud المرتبط بجهة الإصدار الخاصة بك وقم بتنزيل مفتاح JSON الخاص به. اتبع دليل Google حول إنشاء بيانات اعتماد REST API. يجب أن يكون ملف المفتاح من نوع service_account وأن يحتوي على client_email ومفتاح خاص PEM.
2. ادعُ client_email لحساب الخدمة إلى جهة الإصدار الخاصة بك في Google Pay & Wallet Console بمستوى الوصول مطور (Developer)، كما هو موضح في دعوة حساب خدمة Pushwoosh.
3. في نموذج Google Wallet في لوحة التحكم، بجانب مفتاح حساب خدمة خاص بك (JSON، اختياري)، انقر على تصفح… واختر ملف المفتاح .json.
4. انقر على تطبيق.

إذا نقرت لاحقًا على تطبيق دون اختيار ملف، فسيبقى المفتاح المخزّن كما هو.

حافظ على صلاحية الوصول

إذا أزلت حساب الخدمة من مستخدمي جهة الإصدار الخاصة بك، أو ألغيت مفتاحك الخاص، فلن يتمكن Pushwoosh من إنشاء البطاقات أو تحديثها إلى أن تتم استعادة الوصول.

الخطوات التالية

بمجرد النقر على تطبيق، يمكنك تصميم البطاقات في أداة إنشاء البطاقات (pass builder).

تصميم بطاقات Google Wallet في مُنشئ البطاقات

إدارة البطاقات عبر API

استخدم Google Wallet API لإنشاء البطاقات، وإصدار روابط الحفظ، وإرسالها إلى المستخدمين.

واجهة برمجة تطبيقات Google Wallet