Design and Test your Samsung Wallet Cards Using Wallet Studio
Mobassir Ahsan
Engineer, Samsung Developer Program
Samsung Wallet is one of the leading digital wallet services, designed for and available on millions of Samsung Galaxy devices. To ensure that Samsung Wallet partners can easily develop, test and integrate Samsung Wallet cards, Samsung Wallet has recently introduced a new testing suite called Wallet Studio.
Wallet Studio allows Samsung Wallet partners and developers to develop, design, modify and experiment with different types of Samsung Wallet cards for a variety of purposes. Wallet Studio lets partners preview the card's final design in advance, making the Samsung Wallet card development process easier. In this tutorial, you will learn about Wallet Studio and how you can utilize this tool to design and check Samsung Wallet cards in real-time.
About Wallet Studio
Wallet Studio is the complete testing and designing suite introduced by Samsung Wallet. The tool is available at the following URL: https://partner.walletsvc.samsung.com/addToWalletTest
Wallet Studio includes many features to streamline the development and testing process for Samsung Wallet cards. One of its key features is to allow Samsung Wallet partners to preview how these cards will appear on Samsung Galaxy devices once their implementation is complete.
In this article, the following 2 features of Wallet Studio are discussed and you will learn about their use cases:
- Playground – For exploring different types of pre-configured Samsung Wallet cards
- Add to Samsung Wallet – For testing your own cards during development
These 2 features are very similar in nature. Both of them can be used to design and preview Samsung Wallet cards in real-time. However, their use cases are vastly different.
Playground presents Samsung Wallet partners with all possible combinations of preconfigured Samsung Wallet cards. It can therefore be used to check various Samsung Wallet card types and their designs. The feature can be utilized to review design options for different Samsung Wallet cards and their functionalities before you decide to develop a specific card type.
Add to Samsung Wallet is meant for testing your own Samsung Wallet cards. Once you have reviewed the different types of Samsung Wallet cards using Playground and decided on a specific type of card to implement, you can then use the Add to Samsung Wallet feature. To use this feature, you need to create your own Samsung Wallet card templates using the Wallet Partners Portal. Since this feature allows you to directly configure, test, preview and add your own cards using your own private keys and certificate ID, it is best used during the actual implementation of your card.
Prerequisites
To use Wallet Studio, you need to first complete the Samsung Wallet onboarding process.
Once you have completed the onboarding, you can use the Samsung Wallet Playground to check different types of Samsung Wallet cards.
To use Add to Samsung Wallet, you additionally need to do the following:
- Create your own private key & CSR
- Upload the CSR in the Samsung Wallet Partners Portal
- Create at least 1 card template in the Samsung Wallet Partners Portal
Additionally, a supported Samsung Galaxy device with Samsung Wallet installed is necessary in order to perform Add to Samsung Wallet operations on mobile devices.
Checking all card types using Wallet Studio Playground
Wallet Studio's Playground feature provides an easy-to-use Web UI for viewing all possible combinations of Samsung Wallet cards and their subtypes. The purpose of Playground is to check the design and availability of various different Samsung Wallet cards.
In Playground, you can check all available Samsung Wallet cards. These cards are all pre-created for an easier experience. Using Playground, you can preview various Wallet card types and their designs, modify their attributes, and review the changes in real-time, either through the preview pane or by adding the card to Samsung Wallet.
To use Wallet Studio Playground:
-
Visit Wallet Studio at the following URL: https://partner.walletsvc.samsung.com/addToWalletTest
-
Hover on Learn and a pop-up menu appears.
-
Click Playground to use the Playground feature.
Figure 1: Wallet Studio - Playground SelectionOn this page, the card type and subtype dropdown menu is visible in the top-right corner. Select a card type. Its subtype dropdown menu is then populated with all the available subtypes for that card type. Then select a subtype from the dropdown menu and a sample card preview appears for the selected card type.
Alternatively, you can scroll down to the Playground section of Wallet Studio and click on a card type. Then the Playground page appears for the selected card type.
Figure 2: Wallet Studio - PlaygroundOnce you select a card type, you can modify the card's attributes using the text fields, and the changes appear immediately in the preview pane. After modifying the attributes to your liking, you can click the "Add to Samsung Wallet" button, and a Samsung Wallet card with the same design as displayed in the preview pane is added to your wallet. This only applies if you are using Wallet Studio from your Samsung Galaxy device that has Samsung Wallet installed.
Designing your own cards using Add to Samsung Wallet
Add to Samsung Wallet is very similar to Wallet Studio Playground. While Playground offers the ability to experiment with pre-configured Samsung Wallet cards, Add to Samsung Wallet is specifically designed for reviewing and testing your own custom cards.
To visit the Add to Samsung Wallet tab of Wallet Studio:
-
Open Wallet Studio
-
Hover on My Card Container and a pop-up menu appears.
-
Click Add to Samsung Wallet to use the Add to Samsung Wallet feature.
Figure 3: Wallet Studio – Add to Samsung Wallet SelectionThe card templates you created previously appear in the Card Picker area of this page. Before you choose a card, you need to upload your Private Key to Wallet Studio.
To use Add to Samsung Wallet:
-
Click the "Choose File" button.
-
Upload your private key.
-
Select your Certificate ID.
-
Select the desired card template from the card picker.
A preview of the selected card appears below the card picker. You can now design, modify, and experiment with the card, as necessary, using Wallet Studio.
Figure 4: Wallet Studio - Add to Samsung WalletYou can also add the card to your device at any time using the "Add to Wallet" button below the card preview.
Designing and testing Samsung Wallet cards in real-time
Once you select a card in either Add to Samsung Wallet or Playground, a preview of the card and its configurable attributes appear.
All the modifiable attributes for the card are listed in the General section of the page. As soon as you modify an attribute, the preview of the card updates immediately to reflect the changes. This way, you can modify the card attributes and use the preview to monitor the effect on the card in real-time.
Figure 5: Changes Made in Wallet Studio (Reflected Immediately in the Preview)
If you hover over the ? icon of an attribute, it displays the required data type and length for the attribute.
Figure 6: Specification for Each Attribute (Viewed by Hovering Over the "?" Icon)
If you use an invalid data type or exceed the specified data length, the tool warns you in real-time.
Figure 7: Wallet Studio Informing Users if a Value Does Not Meet the Specification
To view the JSON value of the card, use the dropdown menu on the top-right corner of the General section and select JSON. The complete JSON object for the card appears. If you make any modifications to the JSON data, the changes appear immediately in the preview section.
Figure 8: Viewing and Editing the JSON Values Directly in Wallet Studio
To modify the barcode or QR code for the card, click the "Barcode/QR" button and the Barcode section appears.
Click any of the supported barcode or QR code formats and the changes are applied to the card. This way, you can modify the entire card, including the QR and barcodes, using Wallet Studio.
Figure 9: Barcode Type and Values, Modified Using Wallet Studio
Wallet Studio can be used to design and create a complete Samsung Wallet card which can be used as a reference during the card implementation.
Additionally, Wallet Studio can be utilized differently on desktop and mobile devices. In a desktop environment, the Playground and Add to Samsung Wallet tools can be used primarily for designing and previewing Samsung Wallet cards and generating the card's required JSON data. On mobile devices, the preview is not displayed due to the smaller screen. Instead, you can directly add the card to your device's Samsung Wallet using the "Add to Samsung Wallet" button to see how it looks.
Figure 10: Wallet Studio Flow on Mobile Devices
Conclusion
In this blog article you learned how you can make use of Wallet Studio to design and test Samsung Wallet cards on Samsung Galaxy devices. With this knowledge, feel free to proceed to the next steps of implementing Samsung Wallet cards.
For additional reference you can check out the following resources:
- Visit the Samsung Wallet Documentation.
- Check previous blogs on Samsung Wallet to learn about various features of Samsung Wallet.
- Learn how you can generate CData in real-time .
- Learn how to handle Samsung Wallet card updates.
- For additional queries and support, feel free to reach out to us through the Samsung Developer Forum.
