Wallet Portal On-boarding Information

Please review the attached partner on-boarding guide for the Samsung Wallet portal. The RP partner needs registration information on the Wallet Portal.
Wallet portal currently offers 'Add to Wallet' & ‘Verify with Wallet’ functionality to RP partners. Please proceed with the registration by referring to the URL of the developer site below.

Connect to Partner Portal

The Wallet partners portal access is via URL below:
Connect to the Wallet Partners Portal

Partner Onboarding

Partner on-boarding details are accessed via URL below:
Partner Onboarding

Manage Wallet Cards

To use the online RP function, you need to create a card as a Relying Party type.
Refer to the Manage Wallet Cards

Overall Managing Process

The following image illustrates the process of managing Samsung Wallet cards.

Create Wallet Cards (Draft Status)

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

Manage Wallet Cards

• Partners can manage all registered wallet cards.
• Partners can edit wallet cards and check their status .

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 Samsung Wallet.

Item	Description
Testing Mode	All data generated during 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(automatically generated)
Partner App Package Name	Partner app package name
Wallet Card Template	Pre-defined partner’s wallet card template(Type > Sub Type > Design Type)
Wallet Card custom setting
type	Authentication issuer	Set the Authentication issuer for the Relying Party service to be provided as this Wallet Card. Please select Authentication issuers from the identity provider groups. Only Authentication issuers with the same “Service Location” as the Relying Party service are displayed. ※ The Identity Provider of the “Authentication issuer”is supported depending on the "Service Location" set
Partner RP Get request data	URL through which a partner receives a card data inquiry API call In case of Web2App method, the partner should provide this API (/rp/v1.0/{cardId}/{RefId}/key). ※ The attribute could be activated with the approval of a manager.
Partner RP Send authentication data	URL through which a partner receives a card data inquiry API call In case of Web2App method, the partner should provide this API (/rp/v1.0/{cardId}/{RefId}/auth). ※ The attribute could be activated with the approval of a manager.
Samsung Server IPs	Samsung Wallet Server IPs which need to be allowed at the partner’s firewall (separately described for inbound and outbound calls)
Service Location	Select a regional limit for the wallet card. If there was no selected location, the wallet card is shown in all locations. If the specified location was selected, the wallet card is shown only in the selected location. Users can 'Verify with Samsung Wallet' only in Service locations where the wallet service is provided. ※ The Identity Provider of the “Authentication issuer” is supported depending on the "Service Location" set.
Main(Headquarters) Location	Check to set it as a 'Main location'. As the company's main service country(head office) for creating and proceeding with wallet cards, notification e-mails such as wallet card approval requests are sent only to the selected main location.
Wallet Card data save in Server	Set whether to store Wallet Card data in the server to protect personal information. If the card has sensitive information, you can contact the Developer Support Team not to save it.
Description	Description of the wallet card

Select Template

Partners can choose from various types of wallet card templates optimized for partners such as boarding pass, ticket, coupon, and digital ID.
※ For RP Partners : Select "Relying Party type > Other sub type" to set the Relying Party Wallet Card.

Partners can select the type of wallet card needed 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 custom setting
You must set the attributes of the "Wallet Card custom setting" according to the Wallet Card Ttype you selected.
※ For RP Partners: The "Authentication issuer" attribute is a unique property of the Relying Party card.

The Identity Provider of the Authentication issuer is supported depending on the "Service Location" set.
e.g. If Service Location is in the US, the Authentication Issuer field only supports an Identity Provider belonging to the US.

When the parent hierarchy value is checked, its children values created later are automatically checked.

In the United States, the Authentication issuer is the state government, and the driver's license can be understood as an mDL (mobile driver's license).

View Wallet Card

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

Launch Wallet Cards (Verifying Status)

Partners 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, Partners can modify and re-launch.

• The administrator registers the reason for rejection when rejecting a launched wallet card
• Partners will receive an email from the system, including the reason for rejection
• Partners can apply for launching again by checking the reason for rejection and modifying the wallet card information

Testing Mode

Partners can test a card internally to make sure everything works before officially release to the 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. (Testing mode ON → Testing mode Off)

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 becomes visible to the user.

Verify with Samsung Wallet Integration

To integrate the Wallet, you need to run the ‘Verify with Samsung Wallet’ script into your system. The Verify with Samsung Wallet script is available for both Web and Android platforms. Each system has a different composition. To implement the Verify with Samsung Wallet button,
follow the steps below in order.

1. Create 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.
2. Copy the sample Verify with Samsung Wallet script from Partner portal’s Wallet Card page and replace cdata with the data token created above.
3. Apply the script to your system. Please see Web_Integration Sample Code and App_Integration Sample Code for detail.

Below are ‘Verify with Samsung Wallet’ script guide in Partner portal.

To integrate the ‘Verify with Samsung Wallet’ you may need some base data. You can find this base data and other necessary information on the Partner Portal and the Wallet API Spec . You can also add image beacon in the script for tracking effect analysis.