5.1 Overview

Once your service is successfully onboarded, you gain the ability to design and deploy custom digital assets—such as boarding passes, coupons, tickets, and more—directly to Samsung Wallet.

Create a Base Template

Before issuing any new wallet item (or "Wallet Card"), you must first create a Base Template. This serves as the foundation for your custom card types.

Card Management Tools

You can manage your Wallet Cards using two primary tools:

  • Wallet Partners Portal
    • Ideal for creating and managing individual or smaller batches of cards.
    • Provides a user-friendly interface for status management, updates, and review.
  • Server API Access
    • Designed for partners managing a high volume of cards.
    • Allows for automation and scalable integration.
    • Cards created via API are still visible and manageable through the Wallet Partners Portal.

Card Lifecycle & Status States

Wallet Cards go through several status changes during their lifecycle. Each status affects what actions can be taken on a card.

State

 Description
DRAFT

 Initial state when a card is first created. All fields and settings are fully editable.
VERIFYING

 Verification process by Samsung administrators. Requires completion of General Information and CSR (Certificate Signing Request) registration.
REJECTED

 Card did not pass verification. Rejection reasons are emailed to the partner. Cards can be revised and resubmitted.
ACTIVE

 Card has been approved and is now visible to users. Activation is final and cannot be undone.
BLOCKED

 Card has been blocked by Samsung (administrator-only action).

Important: Testing Mode

  • Cards are automatically placed into Testing Mode when first created.
  • In this mode, the card is not live to end users.
  • You must manually switch Testing Mode OFF once testing is complete.

Adding Wallet Cards to Users

  • Wallet Cards can be added to a user's Samsung Wallet in two ways:
  • Standard Add Flow – User initiates the addition (e.g., via a QR code or deep link).
  • Automatic Add (Special Case) – Select partners may be authorized to add cards automatically, without direct user interaction.

This functionality is strictly regulated and reserved for approved use cases only.