Manage Wallet Card

The Samsung Wallet Partners Portal provides partners with the necessary tools and functionality to integrate the “Add to Samsung Wallet” feature into their services. This guide outlines the process of registering, managing wallet cards, and ensuring that everything runs smoothly. Refer to the Partner Onboarding guide for the Samsung Wallet portal.

The Partners need to complete the following steps to register and gain access to the Samsung Wallet Portal.

Note-Wallet portal currently offers 'Add to Samsung Wallet' functionality to the partners.

Overall Managing Process

Once registered and logged into the Samsung Wallet Portal, partners can follow the steps to manage wallet cards and monitor performance:

Step 1 - Create Wallet Cards Templates

Begin by drafting the cards that will be added to Samsung Wallet. These cards can include loyalty cards, tickets, boarding passes, and more. Draft Status - Initially, these cards will be in Draft status until they are fully configured and ready for testing.

Manage Cards

Partners can manage all registered wallet cards. This includes edit, update, and monitor the status of the wallet cards.

General Information

The General Information page allows the partner to enter administrative details to manage their cards, as well as to define common parameters for the wallet.

Folder	Contents
Testing mode	All data generated in Testing mode is periodically deleted. Be sure to turn off the "Testing mode" setting after the test is over.
Wallet Card name	Representative title of the wallet card.
Wallet Card ID	Unique wallet card domain name.
Partner app package name	Partner application package name.
Wallet Card Template	Pre-defined partner wallet card template.
Partner Get card data	URL for the partner API call to receive card data. If the partner uses this API, enter the URL. Otherwise leave it blank.
Partner Send card state	URL for the partner API call to send a card state notification. If the partner uses this API, enter the URL. Otherwise leave it blank.
Samsung Server IPs	Samsung Wallet Server IPs which need to be allowed by the partner’s firewall, separately described for inbound and outbound.
Wearable Wallet assistance	Whether to support the Wearable Wallet service.
Support ‘No Network’ status	Whether to support wallet card opening during the ‘No Network’ status.
Description	Description of the wallet card.

Select Template

The Samsung Wallet Portal offers various wallet card templates optimized for different use cases, including boarding passes, tickets, coupons, and digital IDs.

To streamline your integration, you can easily select the appropriate template from the Select Wallet Card Template pop-up window.

Steps to select Wallet Card Template

Navigate to the Select Wallet Card Template option within the portal.
In the Wallet Card Type drop-down menu, select the category that best suits your use case (e.g., Boarding Pass, Ticket, Coupon, or Digital ID).
Once the card type is selected, a list of templates will appear in the Wallet Card Sub Type section.
Choose one of the available templates from the list that corresponds to your selected card type.
After selecting the template, you can proceed with configuring the card’s details, including the branding, content, and data fields specific to the selected template.

Samsung Wallet supports various wallet card types designed to cater to different use cases. Each card type is optimized for specific functions, making it easier for partners to provide a seamless experience to users.

Note-Refer to section Wallet Card Type to learn more about it.

View Wallet Cards

Partners can easily manage all their registered wallet cards through the Samsung Wallet Portal. This includes the ability to view, edit, and delete wallet cards as needed.

Step 2 - Launch Wallet Cards (Verifying status)

Once a wallet card is ready for launch, it must go through the Verifying status before it can be activated and made available to users. Partners can launch and activate their cards once they have been reviewed and approved, ensuring the card meets all requirements.

Steps to launch wallet cards

To begin the launch process, click Yes to confirm and approve the activation of the wallet card.
To begin the activation process, click the Launch button for the card you wish to activate.
Once a card is launched, the button text changes to Launched. The activation cannot be cancelled.
After the card is launched, its status will change to Verifying. During this stage, the system will conduct a final review to ensure all information is accurate and meets the necessary requirements.
After verification, the card will undergo administrator approval. The admin will review and approve the card for activation.
Once the card is approved by the administrator, its status will change to Active, making it available for users to add to their Samsung Wallet.

Launch Wallet Cards (Rejected status)

If the wallet card is rejected after launching, you can modify the card and re-launch.

Steps to modify the card and re-launch

The administrator registers the reason for rejection when rejecting the launched wallet card.
It is sent to the partner by email from the system, including the reason for rejection.
Partners can apply for launch again by checking the reason for rejection and modifying the wallet card information.

Step 3 – Testing Mode

Partners can use the Testing Mode to test a wallet card internally before it is officially released to users. This feature ensures that all aspects of the card, including its functionality and user experience, are working as expected.

When you create a new wallet card, the Testing Mode option is enabled by default, allowing you to perform internal tests without affecting user access.
All data generated during testing is periodically deleted to ensure that no test data remains in the system once testing is complete.
Even though Testing Mode is enabled, the card is still visible and accessible in the system. Testing does not prevent the card from being exposed to users, so you can verify its functionality without any restrictions.
Once testing is complete and you are satisfied with the card’s performance, be sure to turn off Testing Mode.

Note-Remember to change the status from Testing Mode ON to Testing Mode OFF to finalize the testing process and prepare the card for official release.

Step 4 - Admin Approval (Active Status)

After a wallet card is launched, it must go through an administrator approval process before it becomes active and visible to users.

Steps for Admin approval

Once the Launch button is clicked, the card’s status automatically changes to Verifying.
During this stage, the card is reviewed for accuracy, completeness, and compliance with Samsung Wallet requirements.

Note-Please ensure that testing is completed using either your own implementation or the Add to Wallet test tool, as the Samsung Wallet administrator will verify the results through server-side test logs.
An administrator will review the submitted wallet card to ensure it meets all content and technical guidelines. If the card passes the review, it is approved for activation.
Upon administrator approval, the card status updates 'Active'.
Once the card reaches Active status, it becomes visible and accessible to end users, enabling them to add it to their wallets.

Step 5 – Add to Samsung Wallet Integration

To integrate the "Add to Samsung Wallet" feature into your system, you need to insert the appropriate "Add to Wallet" script. This script is available for various platforms, including Web, Android, and Email/MMS, and each platform requires a slightly different implementation approach.

Follow the steps below to successfully implement the "Add to Wallet" button:

Create the tokenized card data, known as Cdata, which contains the actual wallet card content.

Note-Since CData has a Time-To-Live (TTL) of 30 seconds, it is recommended that the system generates CData in real time to ensure it remains valid when processed.
The Cdata format varies depending on the card type (e.g., loyalty card, ticket, coupon).
Refer to the Cdata Generation Sample Code on the Partners Portal for detailed guidance.
Copy the sample ‘Add to Wallet’ script from Partners Portal’s Wallet Card page.
Replace the placeholder "cdata" in the script with your generated tokenized card data.
Apply the script to your system. See Partners Portal’s Wallet Card for details.

Note-For "Add to Wallet" integration, you may need some base data. You can find that and other necessary information on Partners Portal and Wallet API Spec. You can also add image beacon in the script for tracking effect analysis.

Add to Wallet Script Guide

Wallet Card Types

Wallet card type: Boarding pass

Ideal for airlines, train services, or event check-ins. Allows users to add their travel or event tickets to Samsung Wallet for easy access and quick scanning.

Wallet card type: Tickets

Designed for digital tickets to events such as concerts, movies, sports games, or other events. Ensures smooth entry by providing users with a digital copy of their ticket directly on their device.

Wallet card type: Coupons

Perfect for promotional offers, discount vouchers, gift cards, or loyalty rewards. Users can redeem or use these coupons directly from their Samsung Wallet, making the process faster and more efficient.

Wallet card type: Digital ID

Used for membership cards, loyalty programs, and identification purposes. Can store digital versions of cards like gym memberships, library cards, or other forms of identification.

Wallet card type: Gift card

Digital versions of physical gift cards, which users can add to their Samsung Wallet for quick and easy access. Useful for retail, online stores, and various gift card services.

Wallet card type: Loyalty Card

Designed for businesses offering loyalty programs where customers earn points for purchases or engagement. Users can view their point balance, check available rewards, and redeem points directly from their Samsung Wallet.