Quantcast
Jump to content


Recommended Posts

Posted

2024-11-05-01-banner-v2.jpg

Samsung Wallet is introducing a new feature called "Generic Card" for partners who cannot use other card types to fulfill their business requirements. This provides flexibility to modify various field labels for the card, according to the partners’ business needs.

Other cards, such as boarding passes and coupons serve a specific purpose, and their field labels cannot be modified. However, with a generic card, the label can be modified so it can be used for multiple purposes.

In this article, you learn how to modify a generic card to use it as an insurance card. We will explain the details specification with example of the generic card. At the end of the article a guide will be provided to implement this card for your reference, to help you modify your generic card according to your needs.

Card setup

Before you begin creating a new card template, log in to the Samsung Wallet Partner site and create a generic card.

  1. Log in to the Samsung Wallet Partner site.
  2. Go to the Wallet Cards and then Create Wallet Card. For more details about creating a card, check the Manage Wallet Cards documentation.
  3. Select Generic Card from the available card templates.
  4. Modify the card information.

When you have finished editing card information, launch the card to complete card setup. For more information on how to launch the card, see Launch Wallet Cards.

Template editor

Use the template editor to modify the card template.

2024-11-19-01-01.jpg

  1. From the "CardArt" view, you can modify the card color, set a background image or change the logo image properties.
  2. From the "Enlarge" view, you can modify the {{text1}} and {{text2}} labels. However, only the label itself can be changed in the Template Editor. To set the label value, you need to update the JSON file.
  3. From the "Detail" view, you can modify the "TextGroup" and "AppLink" properties. Modify the text label according to your needs. It is also possible to add new text fields, with a maximum of 12 text fields allowed.

After every modification, click Save. Finally, apply all changes by clicking Apply. If you want to preview your changes, just click Preview.

Add to Samsung Wallet

Now that the card has been created in the site, it is ready to be distributed to fulfill your business needs.

  1. Implement the "Add to Samsung Wallet" functionality to the platform where you are planning to distribute the cards.
  2. When users click "Add to Samsung Wallet," the card is added to the Wallet application on the user’s Galaxy device. This functionality can be added through the application/mobile web, MMS, or email.
  3. Additionally, you can use a QR code on a computer web browser and KIOSK. Samsung provides a Codelab guide for developers so that they can easily understand the implementation. For additional information on the Codelab guide, read Utilize the Add to Samsung Wallet service for digital cards. Further details can also be found in the Implementing ATW button documentation.

Card specifications

To complete the "Add to Samsung Wallet" button implementation, you must generate the Card Data token and create a final URL. For more information, see Add to Samsung Wallet. Let’s start by reviewing the generic card specifications to generate the Card Data token. The generic card follows the specifications below. For more information on them, see the Generic Card section.

Name

Description

Title

The main title of the generic card. In the sample card, the title is "Card Title." In the image below, the title is "Insurance Identification Card."
2024-11-19-01-02.jpg

Subtitle

The subtitle of the generic card. In the sample card, it is "Card Subtitle".

providerName

Use this field to set the card provider name. For more information, check the Card JSON Example below. However, the provider name depends on your card type and should be modified accordingly.

eventId

Enter an ID as an event identifier. In case your card is prepaid, for example a gift card, or if you have vouchers to events, such as concerts, it is possible to define an event ID. For instance: "event-001".

groupingId

Enter an identifier to group related cards.

startDate

Enter the starting date and the epoch timestamp in milliseconds.

startDate.relativeNotiTime

Enter the amount of time within which you want to provide a notification to the user. The notification time is the relative time from the startDate. The value can be up to 2880 milliseconds.

endDate

Enter the end date and the epoch timestamp in milliseconds.

endDate.relativeNotiTime

Enter the amount of time within which you want to provide a notification to the user. The notification time is the relative time from the endDate. The value can be up to 2880 milliseconds.

logoImage

Set the logo image URL. The file size must not exceed 256 KB. Also this image can be set from the Template Editor.
2024-11-19-01-10.jpg

logoImage.darkUrl

Set the logo image URL for the dark mode. The file size must not exceed 256 KB.

logoImage.lightUrl

Set the logo image URL for the light mode. The file size must not exceed 256 KB.

bgImage

Set the background image URL. The file size must not exceed 512 KB.

text{i}

Set the label-text value that should be displayed for each field containing the details of your card. The label is defined in the Template Editor, shown in the image below.
2024-11-19-01-04.jpg

To set the value of the label, update the JSON file.
2024-11-19-01-03.jpg

image{i}

Enter the image URL, such as: "https://www.samsung.com/images/image1.png". This URL is just an example, you must update it according to your needs. This field only works in Generic Card Type3. We have used a Type1 card in the example. So this field in the example JSON has no effect on the card. You can find all three card type sample UIs here.

image{i}.lightUrl

Enter the image URL in light mode, such as: "https://www.samsung.com/images/light.png". This URL is just an example, you must update it according to your needs.

image{i}.darkUrl

Enter the image URL in dark mode, such as: "https://www.samsung.com/images/dark.png". This URL is just an example, you must update it according to your needs.

serial{i}

Set the serial for barcode or QR code.

serial{i}.serialType

Serial presentation type. For more information on the Presentation Types (serialType), see References.

serial{i}.ptFormat

Set the presentation format. For more details on the presentation formats (ptFormat), see References.

serial{i}.ptSubFormat

Set the presentation subformat here. For more details on the barcode formats (ptSubFormat), see References.

serial{i}.errorCorrectionLevel

Set the error correction levels in this field. The amount of redundancy or error correction data included in the code varies. QR codes offer four levels of error correction: L, M, Q, and H. The QR field looks like the following in your card:

  • undefined
  • undefined
privacyModeYn

Set the user authentication if required. Set the value to "Y" or "N"

bgColor

Set the card art color.

fontColor

Set the card art font color.

noNetworkSupportYn

Set the value to "Y" to open the wallet card when under the "No network" status. Otherwise, set the value to "N"

noticeDesc

Set the the notice description here. See the image below of how it is added to card.
2024-11-19-01-07.jpg

appLinkLogo

Add the application link logo URL in this field.

appLinkName

Add the application link name in this field.

appLinkData

Add the application link URL in this field.
2024-11-19-01-08_v2.jpg

locations

List of locations where the card will be used. This information can be used to provide location-based services. Samsung Wallet can use this information to show maps, names of places, and addresses. For more information on the locations field and JSON format, check References.
2024-11-19-01-09_v2.jpg

Card JSON example

In previous sections, you have learned about the card specifications. Next, let’s implement the generic card fields according to your needs. In this section, as the aim is to create an insurance card, you must use the fields accordingly.

Samsung provides a specifically formatted JSON structure. You need to configure the card data objects within the structure’s data array. For more details, see the Generic Card section.

{
    "card": {
        "type": "generic",
        "subType": "others",
        "data": [
            {
                "createdAt": 1709712961000,
                "updatedAt": 1709712961000,
                "language": "en ",
                "refId": "933533e1-9284-461c-905f-bc177526a8d1",
                "attributes": {
                    "title": "Insurance Identification Card",
                    "subtitle": "Insurance Card",
                    "providerName": "Samsung Insurance Co.",
                    "eventId": "1",
                    "groupingId":"1",
                    "startDate": 1731299205000,
                    "startDate.relativeNotiTime": 500,
                    "endDate": 1731320805000,
                    "endDate.relativeNotiTime": 400,
                    "logoImage": "https://us-cdn-gpp.stg.mcsvc.samsung.com/mcp25/resource/2023/12/20/55ea769f-d14d-4c47-94cc-50cade36cdd9.png",
                    "logoImage.darkUrl": "https://us-cdn-gpp.stg.mcsvc.samsung.com/mcp25/resource/2023/12/20/55ea769f-d14d-4c47-94cc-50cade36cdd9.png",
                    "logoImage.lightUrl": "https://us-cdn-gpp.stg.mcsvc.samsung.com/mcp25/resource/2023/12/20/55ea769f-d14d-4c47-94cc-50cade36cdd9.png",
                    "bgImage": "",
                    "text1": "1234567",
                    "text2": "Samsung Insurance Co.",
                    "text3": "Jaqueline M",
                    "text4": "Samsung Motors 2014 Galaxy5",
                    "text5": "11SAM23SUNG3T",
                    "text6": "(031)000-1235",
                    "image1": "https://us-cdn-gpp.mcsvc.samsung.com/mcp25/resource/2024/3/5/b9445e3f-2ef5-4d81-9fca-b7a8a7cd599f.png",
                    "image1.darkUrl": "https://us-cdn-gpp.mcsvc.samsung.com/mcp25/resource/2024/3/5/b9445e3f-2ef5-4d81-9fca-b7a8a7cd599f.png",
                    "image1.lightUrl": "https://us-cdn-gpp.mcsvc.samsung.com/mcp25/resource/2024/3/5/b9445e3f-2ef5-4d81-9fca-b7a8a7cd599f.png",
                    "serial1.value": ">1180MM2241B7C 0000000000000298060000000000 0      090870907           ",
                    "serial1.serialType": "QRCODE",
                    "serial1.ptFormat": "QRCODE",
                    "serial1.ptSubFormat": "QR_CODE",
                    "serial1.errorCorrectionLevel": "M",
                    "privacyModeYn": "Y",
                    "bgColor": "#3396ff",
                    "fontColor": "#FFFFFF",
                    "noNetworkSupportYn": "N",
					"noticeDesc": "{\"count\":2,\"info\":[{\"title\":\"NOTICE1\",\"content\":[\"DESCRIPTION1\",\"DESCRIPTION2\"]},{\"title\":\"NOTICE2\",\"content\":[\"DESCRIPTION1\",\"DESCRIPTION2\"]}]}",
                    "appLinkLogo": "https://www.samsung.com/logo.png",
                    "appLinkData": "https://www.samsung.com/",
                    "appLinkName": "Samsung Insurance Co.",
                    "locations": "[{\"lat\": 37.2573276, \"lng\": 127.0528215, \"address\": \"Suwon\", \"name\": \"Digital City\"}]"
                }
            }
        ]
    }
}

Generic card testing with the "Add to Wallet" test tool

Now, you can test the generic card with the "Add to Wallet" test tool provided by Samsung. Just follow these steps:

  1. Sign in to the Add to Wallet test tool. For more information, see the Samsung Wallet Test Tool.
  2. Enter the private key in the "Enter Partner Private Key" field.
  3. In this tool, you find all cards that you have created from the Samsung Wallet Partner site in the "Select Card" section. For more information, see the Samsung Wallet Partner site.
  4. Select the generic card that you have just created.
  5. Now select JSON from the Data field and modify the existing JSON data fields according to the card specification details.
  6. After modifying the JSON data fields, check if the JSON is valid.
  7. Finally, if the private key is valid, the "Add to Samsung Wallet" button becomes active at the bottom of the page. Then, just click Add to Samsung Wallet to finish adding the generic card.

If you use the provided example JSON and add the card to the wallet, the card looks like the following:

undefined
undefined
undefined
undefined
undefined

Server integration

In this step, server configuration is needed because the generated JWT token expires after 30 seconds. Developers are advised to only generate this token after a user has clicked the "Add to Wallet" button. As you have already performed testing with the "Add to Wallet" test tool, you need to configure your server.

For more information on the implementation of both the "Add to Samsung Wallet" button and server-side logic, see Implementing "Add to Wallet" in an Android Application. This article explains how you can distribute your card with your Android application and how to generate the JWT token at runtime, after pressing the "Add to Samsung Wallet" button.

Conclusion

You have now learned the basics for how to set up a generic card and test it for your business needs. In case you have further questions, contact Samsung Developer Support.

View the full blog at its source



  • Replies 0
  • Created
  • Last Reply

Top Posters In This Topic

Popular Days

Top Posters In This Topic

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...
  • Similar Topics

    • By mramnesia97
      My Samsung Smart TV's (Model Code: QE55Q80AATXXC) app window is completely broken. I'm trying to enable developer mode but as soon as I enter "Apps" the window is frozen. I cannot scroll or click on anything. I can activate to press the 123 digits, but nothing happens when I try to input 1,2,3,4,5
      I've tried resetting the TV completely, unplugged it, cleared cache and everything else I can think off.
      What could possibly cause the Apps drawer to not work and be completely frozen?
    • By Samsung Newsroom
      Samsung is expanding its partnership with Art Basel to Art Basel Miami Beach. Following the debut as Art Basel’s first-ever Official Visual Display partner in Basel, Switzerland earlier this year, complete with an immersive Collectors Lounge experience. Through this unique partnership, Samsung is also launching a new initiative with Art Basel to bring curated collections of contemporary artworks from Art Basel’s renowned exhibiting galleries exclusively to the Samsung Art Store. A new collection will be shared once a quarter with the first collection launching today.
       
      ▲ Fred Tomaselli’s Irwin’s Garden (detail) (2023) shown on The Frame by Samsung. Photo: Samsung
       
      The Samsung Art Store is available on The Frame, the best-selling lifestyle TV from Samsung that doubles as a piece of art. Subscribers around the world can experience gallery highlights from Art Basel, which joins other renowned collections such as those from The Metropolitan Museum of Art, The Museum of Modern Art and The Musée d’Orsay available on the Samsung Art Store. The latest partnership with Art Basel underscores Samsung’s commitment to making world-class art accessible to anyone with The Frame through its innovative platform. 
       
       
      Samsung Art Store Subscribers Get an Exclusive Look
      Art Basel Miami Beach is the premier global art fair of the Americas with cultural significance attracting thousands of art enthusiasts every year. For the first time, this exclusive experience is being delivered directly to the screens of millions of people through The Frame.
       
      Ahead of Art Basel Miami Beach, Samsung Art Store subscribers will have access to a curated collection of 15+ select works from Art Basel’s galleries, some of which will be displayed at the highly anticipated fair, taking place from December 6-8, 2024 at the Miami Beach Convention Center. The collection features pieces from international contemporary galleries, including James Cohan, Kasmin, moniquemeloche, mor charpentier, Nara Roesler, Roberts Projects and Tina Kim, offering subscribers a unique, front-row look at some of Art Basel’s incredible works of art.
       
      ▲ Candida Alvarez’s Mostly Clear (detail) (2023) shown on The Frame by Samsung. Photo: Samsung
       
      Founded in 1970 by gallerists from Basel, Art Basel is the world’s premier art fair for modern and contemporary art. This year in Miami Beach, Art Basel will bring together 286 leading international galleries from 38 countries to present artworks of the highest quality across all media — from painting and sculpture to photography and digital works. Art Basel will once again reaffirm its unparalleled position as a platform for discovery and encounters that drive the art world.
       
      “Art Basel’s mission is to power the world of art by connecting leading artists and galleries with art loving audiences,” said Noah Horowitz, CEO of Art Basel. “Our collaboration with Samsung allows us to extend that reach like never before by broadening access to leading galleries and significant works from established artists to a new generation of emerging talents.”
       
      Yong Su Kim, EVP and Global Head of Video Services and Partnerships at Samsung, echoed the excitement surrounding this partnership. “Art Basel represents the pinnacle of contemporary art, and we are thrilled to amplify that experience with leading display technology that brings art to millions of people,” Kim said. “Through the Samsung Art Store and the lifelike visuals of The Frame, we are making it possible for anyone to experience Art Basel and take part in an iconic cultural moment.”
       
       
      Samsung Art Store Collectors Lounge to Feature Industry Panels, Interactive Activation and More
      As the Official Display Partner of Art Basel Miami Beach, Samsung is hosting a dedicated Samsung Art Store Collectors Lounge from December 4-8 under the concept, “Bringing Art Home,” where attendees can enjoy remarkable artworks on The Frame’s museum-worthy display. In addition, visitors will see The Frame showcased with unique bezels in various colors and designs from DecoTVFrames, an official Samsung partner exclusively available for The Frame.
       
      The Frame will also be installed throughout the fair to present visitors with a variety of vivid screen experiences.
       
      In addition to its dynamic Collectors Lounge experience, Samsung is hosting a series of panel discussions featuring influential voices from the contemporary art world. These sessions include:
       
      Celebrating Women in Art and Technology — Innovation and Expression
      An engaging panel led by Daria Greene, Head of Global Curation at Samsung. This discussion celebrates the journey of female artists and innovators who are redefining the intersection of art and technology. Gain insights into how digital platforms are amplifying voices and breaking new ground in contemporary art. The Future of Digital Art — Innovation, Rights and Connectivity
      Explore the future of digital art in this thought-provoking panel, moderated by Maya Harris, Head of Business Development and Strategic Partnerships at Samsung. This session delves into how technology is reshaping artistic rights, accessibility and the ways institutions and artists connect with global audiences.  
      As the home for Samsung Art Store, The Frame has been refreshed in 2024 to deliver an even more complete artistic and aesthetic experience. That includes Pantone Validated ArtfulColor Certification,1 the industry leading color experts. The Frame is the world’s first and only art TV to achieve this validation, ensuring natural and realistic visuals that wouldn’t look out of place in a gallery. It also sports an Anti-Reflection with Matte Display, helping you limit light distractions so your artwork appears even more true-to-life. The Frame hangs just like a picture flush against the wall and is available in class sizes ranging from 32 to 85 inches.
       
      The Frame also delivers value-add features that you can only find from Samsung — the #1 global TV brand for 18 years and counting.2 Samsung technology makes everything you watch look clearer and crisper, while you enjoy access to 2,700+ free channels, including 400+ premium channels on Samsung TV Plus.3 You can also game without a console through Samsung Gaming Hub,4 use your TV as your smart home hub and ensure your personal data is protected by Samsung Knox security.
       
       
      1 Pantone company provides a universal language of color, called Pantone Matching System, that enables color-critical decisions through every stage of the workflow for brands and manufacturers.
      2 Source: Omdia, Jan 2024. Results are not an endorsement of Samsung. Any reliance on these results is at the third party’s own risk.
      3 Available for free on Samsung Smart TVs released after 2016, Galaxy devices, Smart Monitors, Family Hub refrigerators and the web.
      4 Available games and content may vary by country and model and are subject to change without notice. Certain games require a separate controller. Internet connection and subscription may be required. Requires a Samsung account.
      View the full article
    • By Alex
      Three weeks ago, the company released in India the Samsung Z1, its first smartphone powered by Tizen, a homegrown alternative to Google Inc.’s Android operating system.
       
      This week, Samsung is pushing the Samsung Z1 into Bangladesh, a neighbor of India with more than 150 million people and a similarly low rate of smartphone penetration.
       
      After several missteps and rethinks, Samsung’s strategy for its Tizen smartphones is taking a clear shape: the company is aiming the fledgling platform squarely at first-time smartphone users, many of whom may not even have a bank account. The Samsung Z1 is selling in India for about $90.
       
      To that end, Samsung has been touting the “lightweight” nature of the Tizen operating system, meaning that it requires relatively little computing power and can handle most tasks without requiring pricey high-end specifications.
       
      That same lightweight approach has also allowed Samsung to use Tizen as the platform for many of the devices it is hoping will populate its “connected home,” from televisions to smart watches and home appliances.
       
      Despite concerns that Samsung’s new smartphone would face stiff competition in India, where several local handset makers are touting low-end smartphones — some of them in partnership with Google — Samsung says that its Tizen smartphones have received “positive responses” there.
       
      Positive enough, it seems, to at least push Tizen into a second country.
       
      Source: http://blogs.wsj.com/digits/2015/02/06/samsung-extends-tizen-smartphone-to-bangladesh/
    • By Samsung Newsroom
      Samsung Electronics today announced that Samsung TV Plus, its leading free ad-supported streaming TV (FAST) service, will live stream the 2024 MAMA AWARDS, one of the world’s premier K-pop events. The MAMA AWARDS will be available to fans around the world through Samsung TV Plus’s exclusive K-pop channel, launched earlier this month, marking a major milestone in Samsung’s expansion of global streaming offerings.
       
      The event will take place at the Dolby Theatre in Los Angeles on November 21 and at Kyocera Dome Osaka from November 22-23 local time. Samsung TV Plus will air all three days of the awards ceremony.
       
      “Through strategic partnerships, we’re expanding Samsung TV Plus’s role as a key platform for bringing diverse, high-quality content to audiences worldwide,” said Yonghoon Choi, Executive Vice President of the Visual Display Business at Samsung Electronics. “We’re committed to making Samsung TV Plus a global gateway for premium entertainment, delivering unique local and international content that resonates with viewers everywhere.”
       
       
      Expanding K-Pop Access Through Samsung TV Plus’s New Exclusive Channel

       
      Launched on November 6, “K-POP by CJ ENM” — available exclusively on Samsung TV Plus — brings a rich selection of K-pop content to audiences across North America, Europe and Latin America.1 This new channel offers a diverse mix of performances, music videos, artist interviews and behind-the-scenes footage — including exclusive programming from CJ ENM’s Studio CHOOM, which showcases iconic K-artist choreography up close and in a minimalist setting.
       
      With popular artists like TOMORROW X TOGETHER, aespa, ENHYPEN, Anderson .Paak and J.Y. Park — as well as the genre’s most-watched videos — the K-pop channel establishes Samsung TV Plus as a global leader in streaming K-content and connecting fans worldwide with top K-pop performances.
       
       
      Celebrating a Decade of Streaming Innovation With Samsung TV Plus
      As Samsung TV Plus celebrates its 10th anniversary, it has grown into a powerful force in streaming, with more than 88 million active users2 on Samsung smart TVs powered by Tizen OS. With the recent addition of over 4,000 hours of Korean content in the U.S., Samsung TV Plus has also solidified itself as a leading destination for K-content enthusiasts across the globe.
       
      Through exclusive content partnerships and the inclusion of high-quality K-content like the MAMA AWARDS, Samsung TV Plus continues to deliver unique entertainment experiences to global audiences and set a new standard in free streaming.
       
       
      1 The K-POP by CJ ENM channel is available exclusively on Samsung TV Plus in the U.S., Canada, UK, France, Germany, Italy, Spain, Brazil and Mexico
      2 As of September, there are more than 88 million active users on Samsung smart TVs powered by Tizen OS.
      View the full article





×
×
  • Create New...