مقدمة
قارئ NFC للمحفظة المحمولة WalletMate يعد WalletMate أحد الأجهزة الطرفية المتوافقة مع Google Smart Tap القادرة على قراءة Google Wallet Pass. كما أن WalletMate معتمد من Apple VAS، وقادر على قراءة Apple Wallet Pass. سترشدك هذه الوثيقة إلى كيفية التقدم بطلب وإنشاء Apple Wallet وGoogle Wallet Pass، كما ستقدم سير العمل لاستخدام WalletMate. WalletMate مخصص لخدمة VAS فقط، ويجب استخدامه لقراءة بيانات VAS، ولكن ليس لمعاملات الدفع.
دليل توثيق Apple Wallet Passes
يمكن العثور على وثائق Apple Wallet Passes أدناه على موقع الويب الخاص بشركة Apple.وثائق Apple Wallet Passes:
https://developer.apple.com/documentation/walletpassesستحتاج إلى التسجيل في برنامج Apple Developer قبل أن تتمكن من تصميم وإنشاء وتوزيع وتحديث Apple Passes. يرجى الرجوع إلى التسجيل في برنامج مطوري Apple لإنشاء Apple Pass لمعرفة خطوات التسجيل وإنشاء شهادة Apple Pass.
دليل توثيق Google Smart Tap
يمكن العثور على وثائق Google Smart Tap على الموقع الإلكتروني التالي:
https://developers.google.com/wallet/smart-tap/
نظرة عامة على وثائق Google Wallet Generic Pass:
https://developers.google.com/wallet/generic?authuser=1
توجد بعض المواد السرية الخاصة بـ Google Smart Tap، مثل المعلومات المتعلقة بالتشفير وإدارة المفاتيح، والتي لا يُسمح لنا بمشاركتها أو مناقشتها إلا بعد الحصول على إذن بذلك. إذا كنت مهتمًا بالوصول إلى الرابط ومعرفة المزيد عنه، فيجب عليك طلب الوصول إلى فريق دعم GoogleWallet يمكنك التواصل معهم عبر البريد الإلكتروني.
https://developers.google.com/wallet/smart-tap/guides/implementation/key-management?hl=en&authuser=1
تحضير
、
اختبار محفظة Apple
1.1. قم بتنزيل Acs Apple Test Pass في Apple Wallet
يوفر هذا القسم إجراءً بسيطًا خطوة بخطوة حول كيفية تنزيل ACS Apple Test Pass في Apple Wallet.
1. افتح الكاميرا على iPhone، ثم امسح رمز الاستجابة السريعة الخاص بـ Apple Demo Pass في الشكل 1
2. انقر فوق bit.ly
3. إذا لم تتمكن من الحصول على bit.ly، فيرجى تعيين المتصفح الافتراضي على Safari
4. انقر فوق "التالي" لحفظ ACS Test Pass في Apple Wallet.
1.2. تنزيل Google Test Pass في Google Wallet يوفر هذا القسم إجراءً بسيطًا خطوة بخطوة حول كيفية تنزيل Google Test Pass في Google Wallet.
1. قم بتشغيل الكاميرا على هاتف يعمل بنظام Android أو قم بتنزيل تطبيق مسح رمز الاستجابة السريعة، ثم قم بمسح رمز الاستجابة السريعة Google Demo Pass#1 (بطاقة العرض التوضيحي الأساسية للولاء، الحمولة المتوقعة 2018) أو رمز الاستجابة السريعة Google Demo Pass#2 (بطاقة عرض توضيحية طويلة للولاء تحصل على بيانات إضافية، الحمولة المتوقعة {“data-0″:”data_here0″, …”data-49″:”data_here49”) في الشكل 1
2. يمكنك حفظ كل من Demo Pass إذا لزم الأمر
3. انقر فوق عنوان الويب
4. انقر فوق "إضافة" لحفظ Google Test Pass في Google Wallet.
أداة اختبار ACS VAS
أداة اختبار ACS VAS هي أداة مخصصة لاختبار بطاقات Apple Pay Passes وGoogle Pay Passes التي تدعم NFC باستخدام WalletMate. حاليًا، يتم دعم أداة اختبار ACS VAS في أنظمة Windows وLinux وAndroid وmacOS. إذا كنت ترغب في استخدام أداة اختبار ACS VAS لاحتياجات التطوير المختلفة، فيرجى الاتصال بنا: [email protected]
أداة اختبار ACS VAS (Windows)
1.1 قم بتشغيل أداة اختبار Acs VAs
1. احصل على أحدث إصدار من برنامج تشغيل WalletMate وقم بتنزيله وتثبيته منا
2. قم بفك ضغط الملف ACS_VAS_Test_ Tool_Windows-X.XX الذي قدمه لنا البائع.
3. قم بتوصيل قارئ NFC الخاص بمحفظة WalletMate Mobile Wallet بجهاز الكمبيوتر الخاص بك عبر كابل USB.
4. انتقل إلى ACS_VAS_Test_Tool_Windows-X.XX/exe/، وانقر نقرًا مزدوجًا فوق TestVasTool.exe لتشغيل التطبيق. يوجد كود المصدر C# داخل ACS_VAS_Test_Tool_Windows-X.XX/SourceCode/
5. إذا ظهرت نافذة منبثقة تطلب تثبيت مكونات Microsoft Windows المفقودة، فيرجى تنزيلها وتثبيتها.
6. ستظهر الشاشة التالية إذا تم توصيل قارئ NFC الخاص بمحفظة WalletMate Mobile Wallet بنجاح وتم التعرف عليه بواسطة الكمبيوتر الشخصي، وسوف يظهر اسمه في الزاوية العلوية اليسرى.
1.2. استخدام أداة اختبار Acs VAs مع Acs Test Apple Pass
يوفر هذا القسم إجراءات بسيطة خطوة بخطوة حول كيفية اختبار ACS Test Pass المخزن في AppleWallet باستخدام أداة ACS VAS Test Tool.
1.انتقل إلى علامة التبويب "العرض التوضيحي".
2. اضبط عدد مرات الاقتراع ووقت انتهاء الاقتراع لكل اقتراع، ثم حدد ACS Demo Pass، ثم اضغط على Start (ابدأ). معرف نوع المرور والمفتاح الخاص لـ ACS Demo Pass مبرمجان بشكل ثابت في النسخة التجريبية.
3. اضغط على iPhone/AppleWatch أعلى قارئ NFC الخاص بـ WalletMate MobileWallet.
4. ستظهر رسالة "ACS Test Pass". إذا كان جهاز iPhone الخاص بك محميًا بكلمة مرور/Touch ID/Face ID، فستظهر رسالة تطلب منك إلغاء قفل Pass.
5. انقر على iPhone / AppleWatch في الجزء العلوي من WalletMate MobileWallet NFC Reader مرة أخرى.
6. يجب أن تظهر علامة اختيار على الشاشة، ثم يختفي المرور.
7. يتم عرض رسالة الحمولة ووقت الطباعة في مربع الرسالة.
1.3. اختبار ApplePass المخصص الممكّن بتقنية NFC
يوفر هذا القسم إجراءً بسيطًا خطوة بخطوة حول كيفية استخدام أداة اختبار ACS VAS مع بطاقة NFC المخصصة التي تدعمها. إذا كنت قد أنشأت بطاقة اختبار مخصصة باستخدام Apple، فيجب عليك اتباع الإرشادات الواردة في هذا القسم.
يمكنك الرجوع إلى AppleVAS لمعرفة المزيد حول المتطلبات الأساسية لتصميم ApplePass الخاص بك.
1. انتقل إلى علامة التبويب Config Apple VAS وقم بملء الحقول passTypeIdentifier 1 وPrivateKey 1 (احذر من بناء الجملة).
2. إذا كان لديك تمريرتي اختبار مخصصتين تريد اختبارهما، فيرجى لصق معرف نوع المرور الثاني والمفتاح الخاص في معرف نوع المرور 2 والمفتاح الخاص 2 على التوالي.
3. اضغط على حفظ
4. انتقل إلى علامة التبويب التجريبية، وحدد ClientPass1 أو ClientPass2 واضغط على Start (ابدأ). يشير ClientPass 1 وClientPass 2 إلى passTypeldentifier1 وpass Typ ldentifier 2 والمفتاح الخاص المقابل لهما في علامة تبويب Config Apple VAS.
5. ثم اتبع الإجراء باستخدام أداة ACSVASTestTool مع ACSTestApplePass، ويجب أن تتمكن من استرداد المعلومات المخزنة على CustomNFC-Enabled Pass الخاص بك.
1.4.استخدام أداة اختبار AcsVAsTest مع GoogleTestPass
يوفر هذا القسم إجراءات بسيطة خطوة بخطوة حول كيفية اختبار ACS Test Pass المخزن في GoogleWallet باستخدام أداة ACS VAS Test Tool.
1.انتقل إلى علامة التبويب "العرض التوضيحي".
2. يمكنك ضبط عدد مرات الاقتراع ووقت انتهاء الاقتراع لكل اقتراع، اضغط على زر البدء. اترك علامتي التبويب Config Google Smart Tap وSecure Load في الإعداد الافتراضي إذا كنت ترغب في الاختبار باستخدام Google Demo Test Pass.
3. افتح قفل الشاشة، وقم بتشغيل NFC على جهاز Android الخاص بك، وانقر فوق الهاتف المحمول الذي يعمل بنظام Android أعلى قارئ NFC الخاص بـ WalletMate Mobile Wallet، وسوف تظهر رسالة Google Demo Test Pass على الفور.
4. يتم عرض رسالة الحمولة والطابع الزمني في مربع رسالة علامة التبويب "العرض التوضيحي".
1.5. اختبار GooglePass المخصص الممكّن بتقنية NFC
إذا كنت تريد تطوير NFC-EnabledPass الخاص بك مع Google وقمت بإنشاء LTPK المشفر والمفتاح العام، وقمت بتحميل المفتاح العام إلى حساب Google Wallet APl Issuer الخاص بك، فيمكنك اتباع الإرشادات أدناه واختبار تمريرك باستخدام أداة اختبار ACS VAS.
1. انتقل إلى علامة التبويب "تكوين Google Smart Tap"، وأدخل معرف المجمع، ثم اضغط على "حفظ".
2. انتقل إلى علامة التبويب "التحميل الآمن"، واملأ LTPK المشفر (راجع الحصول على زوج المفاتيح الخاص بك لـ SmartTap)، إلى جانب معرف المجمع وإصدار مفتاح LTPK، ثم اضغط على "حقن LTPK المشفر".
3. ثم اتبع بقية الإجراءات في استخدام أداة اختبار ACS VAS مع Google Tes tPass، ويجب أن تكون قادرًا على استرداد المعلومات المخزنة على CustomNFC-EnabledPass الخاص بك.
