Adding a pass in your app |
001 Add a pass in your app when HUAWEI Wallet is installed but HMS Core (APK) is not |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Verify that HMS Core (APK) is not installed.
- Add a pass in your app.
|
- The page for adding passes is not displayed.
- The system prompts you to install HMS Core (APK).
|
002 Add a pass in your app after signing in with a HUAWEI ID |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
Add a pass in your app. |
- The pass is successfully added.
- The pass is properly displayed on the pass details page in HUAWEI Wallet.
|
003 Add a pass in your app without signing in with a HUAWEI ID |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Add a pass in your app.
- The system prompts you to sign in.
- Sign in with a HUAWEI ID.
|
- The system prompts you to sign in with a HUAWEI ID.
- Sign-in succeeds.
- The pass is successfully added.
- The pass is properly displayed on the pass details page in HUAWEI Wallet.
|
004 Repeatedly add a pass in your app |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Add a pass in your app.
- Verify that the pass is successfully added.
- Add the pass again in your app.
|
The app displays a message indicating that the pass has been added or directly jumps to the pass details page in HUAWEI Wallet. |
Adding a pass via a JWE link |
001 Add a pass in HUAWEI Wallet after signing in with a HUAWEI ID |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Sign in with a HUAWEI ID.
- Tap the link of a pass in your app, and choose to add the pass in HUAWEI Wallet.
- Launch HUAWEI Wallet and check whether the pass is successfully added.
|
- Two options, including HUAWEI Wallet and the browser, are provided for you to add the pass after you tap the pass link.
- A message is displayed, indicating that the pass is successfully added.
- The pass is displayed in HUAWEI Wallet and pass details are correct.
|
002 Add a pass in HUAWEI Wallet without signing in with a HUAWEI ID |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Verify that you have not signed in with a HUAWEI ID.
- Tap the link of a pass in your app, and choose to add the pass in HUAWEI Wallet.
- The system prompts you to sign in.
- Launch HUAWEI Wallet and check whether the pass is successfully added.
|
- Two options, including HUAWEI Wallet and the browser, are provided for you to add the pass after you tap the pass link.
- The system prompts you to sign in with a HUAWEI ID.
- Sign-in succeeds.
- A message is displayed, indicating that the pass is successfully added.
- The pass is displayed in HUAWEI Wallet and pass details are correct.
|
003 Add a pass in the browser after signing in with a HUAWEI ID |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Sign in with a HUAWEI ID.
- Tap the link of a pass in your app, and choose to add the pass in the browser.
- Launch HUAWEI Wallet and check whether the pass is successfully added.
|
- Two options, including HUAWEI Wallet and the browser, are provided for you to add the pass after you tap the pass link.
- A message is displayed, indicating that the pass is successfully added.
- The pass is displayed in HUAWEI Wallet and pass details are correct.
|
004 Add a pass in the browser without signing in with a HUAWEI ID |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Verify that you have not signed in with a HUAWEI ID.
- Tap the link of a pass in your app, and choose to add the pass in the browser.
- Sign in with a HUAWEI ID.
- Launch HUAWEI Wallet and check whether the pass is successfully added.
|
- Two options, including HUAWEI Wallet and the browser, are provided for you to add the pass after you tap the pass link.
- Sign in with a HUAWEI ID.
- Sign-in succeeds.
- A message is displayed, indicating that the pass is successfully added.
- The pass is displayed in HUAWEI Wallet and pass details are correct.
|
Checking the pass details page in HUAWEI Wallet |
001 Check whether fields on the pass details page are consistent with those provided by your app (For details, please refer to the UI design in UI Design.) |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Verify that a pass has been successfully added to HUAWEI Wallet.
- Check whether fields on the pass details page in HUAWEI Wallet are consistent with those provided by your app.
- Verify the UI by referring to the UI Design for each kind of passes.
|
- Fields such as the logo, title, subtitle, and number of the pass are the same as those provided by your app.
- The display is normal. If a field provided by your app is missing on the detail page, the display will not be affected.
|
002 (Optional) Check scrolling images and URLs for redirection effect |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Set scrolling images and URLs and their redirection effect in the model or instance.
- Check the display of scrolling images and tap the images to check the redirection effect.
- Check the display of URLs and tap the URLs to check the redirection effect.
|
- The scrolling images are properly displayed and their redirection effect is normal.
- The URLs are properly displayed and their redirection effect is normal.
|
003 Scan a 2D or 1D barcode to display the expected ticket or card number |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Verify that a pass has been successfully added to HUAWEI Wallet.
- Go to the pass details page and scan the 2D or 1D barcode on the bottom.
|
Data displayed after scanning is consistent with the actual application scenario of the pass, so that the pass can be used properly. |
004 (Optional) Create a coupon whose barcode type is 2D+1D |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Create a coupon whose barcode type is 2D+1D, that is, set fields.barCode.type to codabar|qrCode or qrCode|codabar. View the coupon in preview mode or on its details page.
- Scan the 2D or 1D barcode on the coupon.
|
- Both 2D and 1D barcodes are displayed on the coupon, with the 2D barcode in the upper part.
- The scanning result is consistent with the value of barCode.value.
|
005 (Optional) Create a Use Now coupon supporting redirection to an activity |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Create a Use Now coupon supporting redirection to an activity, that is, set fields.commonFields.use_type to 10, use_button.label to Use Now, and use_button.value to className/action/schema link. View the coupon in preview mode or on its details page.
- Tap the Use Now button on the coupon.
|
- The Use Now button is displayed on the coupon.
- You are redirected to the activity in the link specified by use_button.value.
- If the app in the activity is not installed, the system prompts you to download and install the app based on packageName and AppName in the link.
|
006 (Optional) Create a Use Now coupon supporting redirection to an HTML5 page |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Create a Use Now coupon supporting redirection to an HTML5 page, that is, set fields.commonFields.use_type to 11, use_button.label to Use Now, and use_button.value to an HTML5 (HTTP or HTTPS) link. View the coupon in preview mode or on its details page.
- Tap the Use Now button on the coupon.
|
- The Use Now button is displayed on the coupon.
- You are redirected to the target HTML5 page.
- If the HTML5 page has not been added to the trustlist on the console of Wallet Kit, the page fails to be accessed.
|
007 (Optional) Create a Use Now coupon supporting redirection to a deep link |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Create a Use Now coupon supporting redirection to a deep link, that is, set fields.commonFields.use_type to 12, use_button.label to Use Now, and use_button.value to a deep link. View the coupon in preview mode or on its details page.
- Tap the Use Now button on the coupon.
|
- The Use Now button is displayed on the coupon.
- You are redirected to Quick App Center.
- If the quick app is not installed, you will be prompted to download and install it.
|
008 (Optional) Copy the promo code on a coupon |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Create a coupon with a promo code displayed on it, that is, set fields.commonFields.use_type to 3 and barCode.value to a promo code. View the coupon in preview mode or on its details page.
- Tap Copying a promo code.
|
- A promo code (specified by barCode.value) is displayed on the coupon and the Copying a promo code button is available on the bottom.
- A message is displayed, indicating that the promo code is copied successfully. The pasted code is the same as the original code.
|
009 View an expired pass |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- A pass of your app has been added to HUAWEI Wallet.
|
- Change the value of status.state to inactive, completed, or expired and view the pass on its details page.
- Wait until the pass expires.
|
- The pass is dimmed on the home page and marked with an expiration flag. The 2D barcode on the pass details page is dimmed, and the Expired icon is displayed in the upper right corner.
- Expired passes are moved to the expired pass folder (available only in the Chinese mainland).
|
010 View pass details in dark mode |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Go to Settings > Display & brightness and enable Dark mode.
- Go to the details page of a pass in HUAWEI Wallet.
|
- All elements on the pass are displayed properly in dark mode.
- Other elements on the details page of the pass, such as fields and scrolling images, are displayed properly in dark mode.
|
011 View pass details when large text and display size is used on a phone |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Go to Settings > Display & brightness > Text and display size, and adjust the size to a large one.
- Go to the details page of a pass in HUAWEI Wallet.
|
All elements on both the pass and its details page are displayed properly. |
012 View pass details on a tablet or Mate X phone |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
|
- Go to the details page of a pass in HUAWEI Wallet on a tablet or Mate X (unfolded) phone.
|
All elements on both the pass and its details page are displayed properly on the tablet or Mate X phone. |
Associating a loyalty card with coupons |
001 Associate a loyalty card with coupons when configuring instance information |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Add two coupons (with SerialNumber being Id1 and Id2) to HUAWEI Wallet.
- Add a loyalty card. Add Id1 and Id2 to the value of relatedPassIds of the loyalty card. For details, please refer to Loyalty Card > Associating with a Coupon in this document.
- Check whether the two coupons are displayed on the details page of the loyalty card in addition to bonus points and balance, and tap a coupon.
|
- The loyalty card is added successfully. In addition to bonus points and the balance, associated coupons and their quantity are displayed on the details page.
- The list of all associated coupons is displayed after you tap the coupon.
|
Deleting a pass |
001 Delete a pass that has been successfully added |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Click the delete button to delete a pass on its details page.
- Confirm the deletion.
|
The pass is deleted successfully. |
002 Check whether pass deletion on phone A is synchronized to phone B |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Sign in with the same HUAWEI ID on phones A and B.
- Delete a pass on phone A and check whether the pass is also deleted on phone B.
|
The pass is deleted on both phones A and B. |
003 Delete a pass and add it again by tapping the add button in your app |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Add pass A.
- Delete pass A.
- Add pass A again in your app.
|
Pass A is added, deleted, and then added successfully. |
Updating a pass |
001 Check whether pass change in your app is synchronized to HUAWEI Wallet |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
After a pass is changed (including status change) in your app, check whether the change is synchronized to HUAWEI Wallet. |
The change is synchronized to HUAWEI Wallet. |
Pass notification |
001 Notify the user when a coupon is about to expire |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- HMS Core (APK) has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
Add a coupon that is about to expire within 24 hours. |
Your phone receives a coupon expiration notification. You can tap the notification to go to the coupon details page in HUAWEI Wallet. |
002 Notify the user 3 hours before an event starts |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Use a JSON object to add an event ticket and set the event start time to 3.5 hours after the current time.
- Wait for half an hour and check whether your phone receives a notification indicating that the event is about to start.
- Tap the notification.
|
- Your phone receives a notification indicating that the event is about to start.
- The details page of the event ticket is displayed after you tap the notification.
|
003 Notify the user of event startup when an event ticket is added within 3 hours before the startup |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Use a JSON object to add an event ticket and set the event start time to 1.5 hours after the current time.
- Check whether your phone receives a notification of event startup.
- Tap the notification.
|
- Your phone receives a notification indicating that the event is about to start.
- The details page of the event ticket is displayed after you tap the notification.
|
004 Notify the user 1 hour before the departure time on the train or bus ticket |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Use a JSON object to add a train or bus ticket and set the departure time to 1.5 hours after the current time.
- Wait for half an hour and check whether your phone receives a notification of departure.
- Tap the notification.
|
- Your phone receives a notification indicating that the departure time is about to arrive.
- The details page of the train or bus ticket is displayed after you tap the notification.
|
005 Notify the user 4 hours before the departure time on the boarding pass |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Set the departure time (scheduledDepartureTime) on the boarding pass to 4.5 hours after the current time.
- Enable the notification function for HUAWEI Wallet.
- Wait for half an hour and check whether your phone receives a notification indicating that the departure time is about to arrive.
- Tap the notification.
|
- Your phone receives a notification indicating that the departure time is about to arrive.
- The details page of the boarding pass is displayed after you tap the notification.
|
Notification of boarding pass changes |
001 Notify the user of the boarding gate change |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Change the boarding gate.
- Enable the notification function for HUAWEI Wallet.
- Tap the notification.
|
- Your phone receives a notification indicating that the boarding gate is changed.
- The details page of the boarding pass is displayed after you tap the notification.
|
002 Notify the user of the boarding time change |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Change the boarding time.
- Enable the notification function for HUAWEI Wallet.
- Tap the notification.
|
- Your phone receives a notification indicating that the boarding time is changed.
- The details page of the boarding pass is displayed after you tap the notification.
|
003 Notify the user of the departure time change |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Change the departure time.
- Enable the notification function for HUAWEI Wallet.
- Tap the notification.
|
- Your phone receives a notification indicating that the departure time is changed.
- The details page of the boarding pass is displayed after you tap the notification.
|
Pass expiration |
001 Check the details page of an expired pass |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
- There are expired passes. A pass will be moved to the expired pass folder within 24 hours after its expiration time; a pass will also expire if its State is set to Expired, Inactive, or Complete.
|
Go to the details page of the expired pass in HUAWEI Wallet. |
- The back button and all elements on the coupon are displayed.
- The following content is dimmed: balance or bonus points, 2D barcode, 1D barcode and its number, and the Expired icon displayed in the upper right corner of the pass.
|
002 Go to the details page of an expired pass |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
- All passes have expired.
|
- View expired passes in HUAWEI Wallet.
- Tap a pass.
|
The details page of the pass is displayed. |
003 Delete an expired pass |
- The 4G or Wi-Fi network is normal.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
- A pass has expired.
|
Delete the expired pass. |
The pass is deleted successfully. |
Linking to saved passes |
001 Click the link to a saved pass to view pass details |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
|
- Save a pass and view it using the following URL:
https//:{walletkit_website_url}/walletkit/consumer/pass/instance?issuerId=xxx&instanceId=xxxx
- Replace {walletkit_website_url} in the preceding URL based on the region to which the website belongs.
China: walletpass-drcn.cloud.huawei.com Russia: walletpass-drru.cloud.huawei.com Asia, Africa, and Latin America: walletpass-dra.cloud.huawei.com Europe: walletpass-dre.cloud.huawei.com
- Set issuerId to the merchant ID that you registered with HUAWEI Developers.
- Set instanceId to the value of serialNumber of the pass.
|
The pass is displayed in the browser after you tap the link. |
(Optional) Supporting geofence notifications |
001 Support geofence notifications for loyalty cards, gift cards, and coupons (not available for the Chinese mainland now) |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
- The number of notifications received by HUAWEI Wallet has not reached the upper limit.
- The current time is not in the silent period (00:00 to 06:00).
|
- Add loyalty card A and set locationList to the longitude and latitude of location A.
- Enable the location permission for HUAWEI Wallet and HMS Core (APK), enable the notification permission for HUAWEI Wallet, and go to Me > General to enable Notify when cards can be used in HUAWEI Wallet.
- Check whether your phone receives a consumption notification for loyalty card A when you enter a 200 m radius circle with location A as the center.
|
Your phone receives a geofence notification for loyalty card A, indicating that you are near location A and you can use the card now. |
002 Create a maximum of three geofences |
- The 4G or Wi-Fi network is normal.
- HMS Core (APK) has been upgraded to the latest version.
- HUAWEI Wallet has been upgraded to the latest version.
- You have signed in with a HUAWEI ID.
- The number of notifications received by HUAWEI Wallet has not reached the upper limit.
- The current time is not in the silent period (00:00 to 06:00).
|
- Add loyalty card A and set locationList to three pairs of longitude and latitude, respectively corresponding to locations A, B, and C.
- Enable the location permission for HUAWEI Wallet and HMS Core (APK), enable the notification permission for HUAWEI Wallet, and go to Me > General to enable Notify when cards can be used in HUAWEI Wallet.
- Check whether your phone receives a consumption notification for loyalty card A when you enter a 200 m radius circle with location A, B, or C as the center.
|
Your phone receives a geofence notification for loyalty card A, indicating that you are near location A, B, or C and you can use the card now. |