Mix Personalised Reward Taking part in Playing cards For A Seamless Pockets Experience

Samsung Pockets permits clients to conveniently retailer and entry charge enjoying playing cards, passes, and now moreover personalized reward enjoying playing cards—multi useful protected place. With reward card integration, companions can ship a personalized and rewarding experience to their clients, enhancing mannequin connection and individual consolation.

On this text, you study to create and mix your particular person reward card as a affiliate using Samsung Pockets’s card template system. Research to customize visuals, define key particulars like steadiness and expiration date, and permit a seamless ‘Add to Samsung Pockets’ experience in your shoppers.

Reward card setup

Can you dive into the world of Samsung Pockets and create your first card template? Observe these simple steps to get started and produce your ideas to life!

Step 1: Full the onboarding course of when you haven’t completed it already. For particulars, strive the Onboarding Info.

Step 2: Log in to the Pockets Companions Portal. That’s your gateway to creating and managing your pockets enjoying playing cards.

Step 3: As quickly as logged in, head over to the Pockets Taking part in playing cards half. Proper right here, you uncover the Create Pockets Card selection. For further particulars about making a card, don’t overlook to try the Deal with Pockets Taking part in playing cards documentation.

Step 4: Choose the Reward Card template from the guidelines of obtainable card templates.

Step 5: Customise your card. Now comes the pleasant half! Modify the cardboard data to suit your needs. Through adjusting colors, together with logos, or tweaking textual content material, that’s the place your creativity shines.

Step 6: Launch your card as quickly as you’re glad collectively together with your edits. For further particulars on launching, focus on with the Launch Pockets Taking part in playing cards info.

ObserveManaging a lot of enjoying playing cards by the Pockets Companions Portal will likely be tough. Samsung affords Server APIs to simplify the tactic, enabling you to create and modify Samsung Pockets card templates successfully, with out relying on the portal. Uncover the subsequent weblog topic for detailed insights: Create Samsung Pockets Card Templates Using the Server API.

Reward card specs

Sooner than producing the Card Info token for the ‘Add to Samsung Pockets’ button, it’s necessary to understand the development of a sample reward card.
Every reward card in Samsung Pockets is constructed from a defined set of data fields that determine how the cardboard seems and options. These fields are part of the cardboard’s JSON building and administration each little factor from how the cardboard title appears to how barcode info is delivered when scanned.

The following examples illustrate how fully totally different card parts map to the reward card specs. Each image highlights a particular group of parameters used when creating a gift card for Samsung Pockets.

Basic reward card data

This image illustrates the core parts that define the basic building of a gift card in Samsung Pockets. It highlights the required fields—just like title, appLinkName, appLinkData, and appLinkLogo—which administration the cardboard’s major present title and linked actions. Non-obligatory parameters like bgImage enhance the seen design by allowing a personalized background. Collectively, these specs kind the inspiration of the cardboard’s seen construction and branding.

This image demonstrates the specification fields that define the cardboard’s steadiness, expiration date, and barcode info in Samsung Pockets.

This image illustrates how the barcode appears when the individual taps the Pay button on the reward card. The displayed barcode corresponds to barcode.serialType, which specifies the presentation format (just like BARCODE or SERIALNUMBER). This configuration permits clients to redeem their reward enjoying playing cards seamlessly by scanning the code at a service supplier terminal.

This image demonstrates the utilization of the csInfo self-discipline to retailer purchaser assist data. Telephone amount, e-mail take care of, and website take care of data can all be saved in it.

This image illustrates how the reward card’s present language adapts to the individual’s machine language settings by the localization self-discipline. Localization permits the individual to serve content material materials in a lot of languages. When an individual items their machine to a particular language, the corresponding localized content material materials is displayed on their machine.

These specs collectively define how your reward card appears and behaves in Samsung Pockets. For further detailed insights, strive the nice Reward Card doc.

Reward card JSON building

Whenever you’ve reviewed the reward card specs, the next step is to stipulate them throughout the JSON building. This info building accommodates all the parameters that describe your reward card—along with its title, amount, expiration date, barcode particulars, and non-compulsory hyperlinks. The JSON is used to generate the Card Info token, which securely transfers the cardboard data when clients faucet ‘Add to Samsung Pockets’.

The following is an occasion JSON file for a sample reward card:

{
  "card": {
    "type": "giftcard",
    "subType": "others",
    "info": [
      {
        "refId": {refId},
        "createdAt": {createdAt},
        "updatedAt": {updatedAt},
        "language": "en",
        "attributes": {
          "title": "SAMPLE GIFT CARD",
          "eventId": "event-001",
          "logoImage": "https://djcpagh05u38x.cloudfront.net/wlt/kr/stg/IHGhULmHRiqfhI73YdQZcA/GhDKJ4z2Q5O23CwuXSupBg.png",
          "logoImage.darkUrl": "https://djcpagh05u38x.cloudfront.net/wlt/kr/stg/IHGhULmHRiqfhI73YdQZcA/zdzSwFKbTvuvAz35MSKmzw.png",
          "providerName": "Gift Card Provider name testing",
          "user": "John Smith",
          "csInfo": "{"call":"(+82) 1588-3366","website":"https://www.samsung.com/us/"}",
          "appLinkLogo": "https://d3unf4s5rp9dfh.cloudfront.net/TANGO/03-11-2025-wallet-gift-card-applink-logo-image.png",
          "appLinkName": "Gift Card Link",
          "appLinkData": "https://developer.samsung.com/wallet",
          "bgImage": "https://d3unf4s5rp9dfh.cloudfront.net/TANGO/03-11-2025-wallet-gift-card-design-v2.png",
          "fontColor": "",
          "amount": "100P",
          "startDate": {startDate},
          "endDate": {endDate},
          "barcode.value": "SDC0102025",
          "barcode.serialType": "QRCODE",
          "barcode.ptFormat": "QRCODESERIAL",
          "barcode.ptSubFormat": "QR_CODE"
        },
        "localization": [
          {
            "language": "ko",
            "attributes": {
              "title": "삼성 월렛"
            }
          }
        ]
      }
    ]
  }
}

ObserveIn case you don’t specify a fontColor value, it routinely adapts to your system settings. As an illustration, in darkish mode, the font color is delicate, and in delicate mode, it’s darkish.

You’ll have created a gift card throughout the Pockets Companions Portal, now study if the cardboard works accurately sooner than further development course of. Observe these steps to look at the cardboard.

1. Signal as much as the Add to Pockets check out software program, navigate to the Playground half, select the reward card from the dropdown menu, and press Add to Samsung Pockets.

2. Navigate to the Add to Pockets menu on the Add to Pockets check out software program website and observe the step-by-step info equipped throughout the Add to Samsung Pockets Verify half throughout the On-line Verify System documentation.

‘Add to Samsung Pockets’ implementation

After testing the cardboard with the ‘Add to Pockets’ check out software program, you’ll be capable to let clients add it on to Samsung Pockets. Implement the ‘Add to Samsung Pockets’ button so that individual can add the cardboard to their pockets. For further particulars, focus on with the Implementing ATW button documentation.

Throughout the ‘Add to Samsung Pockets’ button implementation course of, the generated JWT token expires after 30 seconds. Due to this, it’s advisable implement the server logic so that this token generates after the individual interaction like pressing a button. See the Implementing “Add to Pockets” in an Android Software program weblog to get particulars on the server-side logic implementation technique of an ‘Add to Samsung Pockets’ button in an Android utility.

Conclusion

Bringing your reward enjoying playing cards to Samsung Pockets creates a protected, seamless, and branded experience in your clients. By defining your card info, producing the token, and enabling the Add to Samsung Pockets transfer, you make digital gifting simple and interesting. Start integrating right now and let clients benefit from useful, personalized gifting inside Samsung Pockets.