1.1 Introduction

Welcome to the Samsung Wallet Cards Integration Guide.

Samsung Wallet is a secure and unified digital wallet solution designed for Samsung Galaxy devices, offering users a convenient way to store and manage a wide range of digital assets—including payment cards, loyalty memberships, travel tickets, coupons, digital IDs, and more. Seamlessly integrated with Samsung’s ecosystem, it enables contactless payments via Samsung Pay, supports biometric authentication for enhanced security, and allows for real-time interactions like push notifications and location-based reminders. Samsung Wallet empowers partners and developers to deliver personalized, digital-first experiences while ensuring user data remains private and protected.

Samsung Wallet is an e-wallet service that allows users of Samsung devices to securely store and access various digital items, such as credit cards, boarding passes, loyalty cards, and digital keys. By combining multiple services into one platform, it streamlines everyday transactions and digital storage in a convenient and user-friendly interface.

Users can add their ticket, coupon, boarding pass, and other types of data into Samsung Wallet using an Add to Wallet link via multiple online channels like App, Web, E-mail, or social media messages.

Benefits of Samsung Wallet cards service:

This document provides an overview for integration partners looking to enable digital items (e.g., tickets, coupons, and passes) on Samsung Wallet. This guide will walk you through the setup, onboarding, implementation, and management steps needed to launch your wallet-enabled services.

This document describes how to implement Samsung Wallet Cards service features from the integration partner's point of view.

A Partner Account is a Samsung developer account registered on the Samsung Wallet Partners Portal. It allows Samsung Wallet partners to manage their Wallet services, register card templates, access credentials (Partner ID, Card ID), and communicate securely with Samsung’s servers.

To integrate with Samsung Wallet Cards, partners follow a structured process that enables their digital content—such as tickets, coupons, and passes—to be stored and managed in the Samsung Wallet app.

The implementation includes the following stages:

Partner Account Setup

To begin, the integration partner must create a Samsung Account and register as a service provider in the Samsung Wallet Partners Portal. This account grants access to tools and resources needed for integration, including card management, API credentials, and documentation.

Onboarding

During onboarding, the partner submits basic company details, once submitted, Samsung issues the following key integration credentials:

  • Partner ID
  • Card ID
  • Certificates for secure communication (via a signed CSR)

These credentials are required for card generation, secure API calls, and managing wallet content.

Add to Samsung Wallet Integration

The partner integrates the "Add to Samsung Wallet" functionality into their digital platforms—such as apps, websites, or emails—by adding a button or link.
When end users click the button, the link triggers the process of creating and storing a digital card in Samsung Wallet.

Partners can deliver content in two ways:

  • Data Transmit Link: Encodes card content directly in a JWT (JSON Web Token)
  • Data Fetch Link: Samsung fetches the content from a partner's server upon user action

Each card is uniquely identified by a reference ID (refId). Reusing the same ID updates the card silently.

Wallet Card Management

After cards are added to users' Samsung Wallet apps, the partner can manage them by interacting with Samsung’s server APIs.

This includes:

  • Updating card content (e.g., time changes, status updates)
  • Sending notifications for specific events
  • Cancelling or deleting cards
  • Receiving events via the Send Card State callback (e.g., when a user adds or removes a card)

These server-to-server communications ensure cards stay current and reflect real-time changes.