Εισαγωγή
WalletMate Mobile Wallet NFC Reader is one of theGoogle Smart Tap capable terminals which is capable to read Google Wallet Pass. WalletMate is also Apple VAS certified, and capable of reading Apple Wallet Pass.This document will guide you on applying, and creating Apple Wallet and Google Wallet Passes, andintroduce the workflow to use WalletMate.WalletMate is VAS-only, it shall be used for reading VAS data, but not for payment transactions.
Apple Wallet Passes Documentation Guide
Apple Wallet Passes documentation can be found below on its website of Apple.Apple Wallet Passes documentation:
https://developer.apple.com/documentation/walletpassesYou will need to enroll in Apple Developer Program before you can design, create, distribute, and update Apple Passes. Please refer to Enroll in Apple developer’s program for Apple Pass generation for stepsto enroll and create an Apple Pass certificate.
Google Smart Tap Documentation Guide
Google Smart Tap documentation can be found below website:
https://developers.google.com/wallet/smart-tap/
Google Wallet Generic Pass documentation overview:
https://developers.google.com/wallet/generic?authuser=1
There are some confidential materials of Google Smart Tap, such as information on Cryptography andKey management which we are not allowed to share or discuss until we are authorized to do so. If youare interested to access the link and know more about it, you need to request access with GoogleWallet Support Team <[email protected]>, you can reach them by email.
https://developers.google.com/wallet/smart-tap/guides/implementation/key-management?hl=en&authuser=1
Preparation
、
Apple Wallet Test
1.1.Download the Acs Apple Test Pass in Apple Wallet
This section provides a simple step-by-step procedure on how to download ACS Apple Test Pass inApple Wallet.
1. Open Camera on iPhone, scan the Apple Demo Pass QR Code in Figure 1
2. Click bit.ly
3.If you can’t get bit.ly, please set the default browser to Safari
4.Click Next to save the ACS Test Pass to Apple Wallet.
1.2.Download the Google Test Pass in Google Wallet This section provides a simple step-by-step procedure on how to download Google Test Pass inGoogle Wallet.
1. Launch Camera on an Android phone or download the QR code scanning app, scan theGoogle Demo Pass#1 QR Code (the Basic loyalty demo pass, expected payload 2018) orGoogle Demo Pass#2 QR Code (a Long loyalty demo pass which get additional data,expected payload {“data-0″:”data_here0″, …”data-49″:”data_here49”) in Figure 1
2.You can save both Demo Pass if needed
3.Click the Web address
4.Click Add to save the Google Test Pass in Google Wallet.
ACS VAS Test Tool
ACS VAS Test Tool is a tool intended to test NFC-enabled Apple Pay Passes and Google Pay Passes with WalletMate. Currently, ACS VAS Test Tool is supported in Windows, Linux, Android and macOS platforms. If you would like to use the ACS VAS Test Tool for various development needs, please contact us: [email protected]
ACS VAS Test Tool (Windows)
1.1 Launch the Acs VAs Test Tool
1.Get and download and install the most updated WalletMate Driver from us
2.Unzip the file ACS_ VAS_Test_ Tool_Windows-X.XX which provided by our salesman.
3.Connect your WalletMate Mobile Wallet NFC Reader to your PC via USB cable.
4.Navigate to ACS_VAS_Test_Tool_Windows-X.XX/exe/, double-click TestVasTool.exe tolaunch the application. The C# Source code is located inside ACS_VAS_Test_Tool_Windows-X.XX/SourceCode/
5. If there is a pop-up dialog asking to install missing Microsoft Windows Components, pleasedownload and install them.
6. The following screen shall appear if the WalletMate Mobile Wallet NFC Reader had been successfully connected and recognized by the PC, its name will appear in the upper top leftcorner.
1.2.Using Acs VAs Test Tool with Acs Test Apple Pass
This section provides simple step-by-step procedures on how to test ACS Test Pass stored in AppleWallet with ACS VAS Test Tool.
1.Go to Demo Tab.
2.Adjust the Number Of Polling and Polling Timeout(s) for each poll, select ACS Demo Pass, and then press Start. The passTypeldentifier & Private Key for ACS Demo Pass is hard-coded intothe demo.
3.Tap the iPhone/ AppleWatch on topof WalletMate MobileWallet NFC Reader.
4. ACS Test Pass will pop up. If your iPhone is password/Touch ID/Face ID protected, there shallbe a prompt asking you to unlock the Pass.
5.Tap the iPhone / AppleWatchon top of WalletMate MobileWallet NFC Reader again.
6.A tick mark should be shown on the screen,and the pass shall disappear.
7.Payload message and times tamp is shown in message box.
1.3.Test Custom NFC-Enabled ApplePass
This section provides a simple step-by-step procedure on how to use ACS VAS Test Tool with yourcustom NFC-Enabled Pass. If you had created your custom test pass with Apple, you should follow theguidance of this section.
You may refer toAppleVAS to learn more about the pre-requires of designing your own ApplePass.
1.Goto the Config Apple VAS Tab and fillinthepassTypeIdentifier 1&PrivateKey 1(Bewareof the syntax) fields.
2.If you have two custom test passes wanted to test, please paste the 2nd passTypeldentifier &Private Key in pass Type Identifier 2 & Private Key 2 respectively.
3.Press Save
4.Goto demo Tab,select ClientPass1 or ClientPass2 and press Start. ClientPass 1and ClientPass 2 refers to the passTypeldentifier1,pass Typ ldentifier 2 and theirs corresponding privatekey in Config Apple VAS Tab.
5.ThenfollowtherestproceduresonUsingACSVASTestToolwithACSTestApplePass,youshould be able toretrieve the information stored onyour own CustomNFC-Enabled Pass.
1.4.UsingAcsVAsTest ToolwithGoogleTestPass
This section provides simple step-by-step procedures on how to test ACS Test Pass stored in GoogleWallet with ACS VAS Test Tool.
1.Go to Demo Tab.
2.You may adjust the Number Of Polling and Polling Timeout(s) for each poll, press Start. Leavethe Config Google Smart Tap and Secure Load tabs in the default setting if you wish to testwith Google Demo Test Pass.
3.Unlock the screen, turn on the NFC on your android device, and tap the android mobile phoneon top of WalletMate Mobile Wallet NFC Reader,the Google Demo Test Pass shall pop upimmediately.
4.Payload message and timestamp is shown in the”Demo”Tab message box.
1.5.Test Custom NFC-Enabled GooglePass
If you want to developyour NFC-EnabledPass withGoogle and had generate the encrypted LTPK andPublic Key, and had uploaded the Public Key into your Google Wallet APl Issuer Account, you canfollow the below guidelines and test your pass with ACS VAS Test Tool.
1. Navigates to Config Google Smart Tap Tab, input the Collector ID, and press Save.
2.Go to the Secure Load Tab, fill in the Encrypted LTPK (Refer to Get Your Key Pair For SmartTap), together with your Collector ID and LTPK Key Version, and then press Inject EncryptedLTPK.
3.Then follow the rest procedures on Using ACS VAS Test Tool with Google Tes tPass,you should be able toretrieve the information stored on your own CustomNFC-EnabledPass.
