How to Use This Guide

Use this chapter to plan the shortest valid route from partner registration to a card added on a test device. You do not need to read the entire specification before you begin.

If this is your first Samsung Wallet Cards integration, read these pages in order:

  1. Integration at a Glance — understand the systems, identifiers and end-to-end flow.
  2. Supported Use Cases — select the card type that matches your service.
  3. Partner Responsibilities — identify the teams and endpoints you need.
  4. Prerequisites — confirm that your account, device and back end are ready.
  5. Access the Wallet Partners Portal and Onboarding and Credentials — obtain the identifiers and certificates used by the integration.
  6. Build Your First Card — follow the minimum implementation path and verify the result.

After the first card works, use Manage Card Lifecycle to implement callbacks and updates. Read Advanced Integrations only if your approved use case requires those capabilities.

Documentation model

The specification is organised by the work a partner performs:

Chapter

 Use it when you need to
1 Get Started

 Plan the integration and complete onboarding.
2 Design Your Card

 Configure a card programme and construct valid card data.
3 Secure Your Integration

 Generate certificates and produce authenticated or encrypted tokens.
4 Add Cards to Samsung Wallet

 Select a link method and expose an Add to Samsung Wallet entry point.
5 Manage Card Lifecycle

 Receive card events and keep cards current after they are added.
6 Advanced Integrations

 Implement optional or scale-oriented capabilities agreed during onboarding.
7 Test and Go Live

 Validate the complete integration and prepare for launch.
8 Reference and Support

 Look up APIs, code resources and support channels.

Terminology used in this guide

  • Partner means the organisation integrating its content or service with Samsung Wallet.
  • Card programme means the partner configuration represented by a Card ID in the Wallet Partners Portal.
  • Card instance means one user's ticket, coupon, pass or other wallet item, identified by refId within a card programme.
  • Template means the layout and operational configuration applied to card instances.
  • ATW means Add to Samsung Wallet.

Unless a section explicitly states otherwise, requirements apply to all supported card types. Card-type-specific requirements are defined in Card Specifications.