Manage Wallet Cards

Overall Managing Process

The following image illustrates the process of managing wallet cards:

Create Wallet Cards (Draft status)

Partners can create and manage your wallet cards with this step-by-step guide.

Manage Wallet Cards

  • You can manage all registered wallet cards.
  • You can edit wallet cards and check the status of 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.

Item Description
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 app package name
Wallet Card Template Pre-defined partner’s wallet card template
Partner Get card data URL which partner receive card data inquiry API call.
If partner uses this API, enter the URL. Otherwise leave it to be blank.

Partner Send card state URL which partner receive card state notice API call.
If partner uses this API, enter the URL. Otherwise leave it to be blank.

Samsung Server IP Samsung Wallet Server IPs which need to be allowed at partner’s firewall. (separately described for inbound and outbound)
Wearable Wallet assistance Whether to support Wearable Wallet service
Support ‘No Network’ status Whether to support wallet card opening under ‘No Network’ status
Description Description of wallet card

Select Template

You can choose from various types of wallet card templates optimized for partners such as boarding pass, ticket, coupon, and digital ID.

You can select the type of wallet card you want to register from the 'Select Wallet Card Template' pop-up. First, select the Wallet Card Type and then select the Wallet Card Sub Type to select one of the templates belonging to it.

  • Wallet card type: Boarding pass

  • Wallet card type: Tickets

  • Wallet card type: Coupons

  • Wallet card type: Digital ID

  • Wallet card type: Gift card

  • Wallet card type: Loyalty

View Wallet Card

You can view all registered information, also edit and delete the wallet card.

Launch Wallet Cards (Verifying status)

You can launch and activate cards.

  • You can activate a card by clicking the Launch button.
  • Once a card is launched, the button text changes to 'Launched'. The activation cannot be canceled.
  • When a card is launched, its status changes to 'Verifying', and then to ‘Active’ after administrator approval.

Launch Wallet Cards (Rejected status)

If the wallet card is rejected after launching, you can modify 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.

Testing Mode

You can test a card internally to make sure everything works before you officially expose it to users.

  • By default, the ‘Testing mode’ option is enabled.
  • All data generated in testing mode is periodically deleted.
  • Card exposure is not affected even when the testing mode is enabled.
  • Be sure to turn off the testing mode after the test is over.

Admin Approval (Active status)

All launched cards are activated after the administrator's approval.

  • When a card is launched, its status changes to 'Verifying' and then to ‘Active’ after administrator approval.
  • When the card is activated, it is made visible to the user.

‘Add to Wallet’ Integration

For Wallet integration, you need to insert ‘Add To Wallet’ script to your system. ‘Add to Wallet’ script is available in Web, Android, Email/MMS. Each system has different script composition. To implement ‘Add to Wallet’ button, we usually follow procedures below.

First, create a tokenized card data (Cdata). Card data is the actual content data of wallet card and it has several format based on card type. Please refer to Generate_Cdata Sample Code for detail.

Second, copy the sample ‘Add to Wallet’ script from Partner portal’s Wallet Card page and replace cdata with the data token created above.

Third, apply the script to your system. Please see Web_Integration Sample Code and App_Integration Sample Code for detail.

Below are ‘Add to Wallet’ script guide in Partner portal.

For ‘Add to Wallet’ integration, you may need some base data. You can find those base data and other necessary information on Partner Portal and Wallet API Spec . You can also add image beacon in the script for tracking effect analysis.

Performance Monitoring

The Samsung Wallet Service is monitored to get an effective measure of the wallet performance.


  • Wallet Card: Total number of wallet cards registered in the portal.
  • Wallet Card Type: Total number of types registered in the portal.
  • Template: Total number of templates registered in the portal.

Recent Trends

  • Provides key indicators and trend charts for the selected period.
  • You can change the period and wallet card type being reviewed.

Stats of Wallet Cards

  • Provides detailed statistical information for the selected wallet card.
  • You can change the period, template, and wallet card type.
  • You can check detailed information and charts for each indicator.