membership registering and distributing applications 1 1 q&a for more information, visit samsung apps tv seller office and read the portal guides here getting started the detailed specifications and features are common with smart tv's, according to the corresponding tizen versions you can easily start from the quick start guide importantalmost all specifications, features, and apis are available to the samsung smart hospitality display devices, like the smart tv however, some of them may be unavailable to the display devices if you have any questions, please contact the tech sales team

membership cards serve as members’ certificates the cards in wallet show loyalty points id cards the id cards are for identification purposes, as well as for access authentication it supports real-time status change as the user's permission is changed notedepending on your country or region, some card types are not supported if you need assistance, please contact us at developer samsung com/dashboard/support the image below shows the process of managing wallet cards for detailed description, see manage wallet cards set up your environment you will need the following latest samsung wallet from galaxy store samsung galaxy device that supports samsung wallet samsung wallet partners portal account internet browser, such as chrome idea such as intellij key pairs, certificate from samsung see encryption setting partner private key partner certificate samsung certificate start your project open your internet browser and go to the following sample partner sites boarding pass - https //codesandbox io/s/wtr5s2 ticket - https //codesandbox io/s/c66tdq coupon - https //codesandbox io/s/p2kym4 gift card - https //codesandbox io/s/hhnr5m loyalty - https //codesandbox io/s/7m78dt id card - https //codesandbox io/s/rsc226 click fork on the selected project to copy and modify the code once done, the forked project has been automatically copied to your codesandbox account modify the index html later for the add to samsung wallet integration notethe next steps require a samsung wallet partners portal account if you wish to check and test the complete code of these sample partner sites, you can jump to you're done! section of this code lab otherwise, you can proceed to learn the process of integrating add to samsung wallet functionality create wallet cards now, go to samsung wallet partners portal and sign in using your samsung partner account on the left sidebar menu, click wallet cards > create wallet card and enter the wallet card details of your chosen card type as below in wallet card template, choose a card type and a sub type select the card template then, click done you can choose from various types of wallet card templates optimized for partners once all the details are entered and the correct template is selected, click save to set the wallet card status to draft launch wallet cards you can launch and request activation of the cards by clicking the launch button upon agreeing to proceed, the launch button text changes to launched and the card status becomes verifying apply the add to samsung wallet script the samsung wallet partners portal includes generated add to samsung wallet scripts for every wallet card created these scripts can be copied and inserted into partner apps web and android or via email/mms go to [add to wallet script guide] of the card s you created click show to see the scripts for web integration and copy the script under web button js code sample notea statistical image beacon is added to the script for tracking effect analysis below are the generated add to samsung wallet scripts of wallet cards created for this code lab copy the script of your chosen card type boarding pass <script src="https //us-cdn-gpp stg mcsvc samsung com/lib/wallet-card js" type="text/javascript"></script> <div id="target_id"></div> <script> samsungwallet addbutton { partnercode "4030093436155138240", cardid "3fre4kmmboq00", cdata "${card data as jwt}", rdclickurl "https //us-rd mcsvc samsung com/statistics/click/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641030840334;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093501522138240;li=0", rdimpressionurl "https //us-rd mcsvc samsung com/statistics/impression/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641030840334;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093501522138240;li=0", targetid "target_id", buttonid "button_id", } ; </script> ticket <script src="https //us-cdn-gpp stg mcsvc samsung com/lib/wallet-card js" type="text/javascript"></script> <div id="target_id"></div> <script> samsungwallet addbutton { partnercode "4030093436155138240", cardid "3fre4mp5mui00", cdata "${card data as jwt}", rdclickurl "https //us-rd mcsvc samsung com/statistics/click/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641034510350;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093588496138240;li=0", rdimpressionurl "https //us-rd mcsvc samsung com/statistics/impression/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641034510350;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093588496138240;li=0", targetid "target_id", buttonid "button_id", } ; </script> coupon <script src="https //us-cdn-gpp stg mcsvc samsung com/lib/wallet-card js" type="text/javascript"></script> <div id="target_id"></div> <script> samsungwallet addbutton { partnercode "4030093436155138240", cardid "3fre4p0otdv00", cdata "${card data as jwt}", rdclickurl "https //us-rd mcsvc samsung com/statistics/click/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641019830286;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093644822138240;li=0", rdimpressionurl "https //us-rd mcsvc samsung com/statistics/impression/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641019830286;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093644822138240;li=0", targetid "target_id", buttonid "button_id", } ; </script> gift card <script src="https //us-cdn-gpp stg mcsvc samsung com/lib/wallet-card js" type="text/javascript"></script> <div id="target_id"></div> <script> samsungwallet addbutton { partnercode "4030093436155138240", cardid "3gna29cgdi7g0", cdata "${card data as jwt}", rdclickurl "https //us-rd mcsvc samsung com/statistics/click/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641019830286;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093644822138240;li=0", rdimpressionurl "https //us-rd mcsvc samsung com/statistics/impression/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641019830286;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093644822138240;li=0", targetid "target_id", buttonid "button_id", } ; </script> loyalty <script src="https //us-cdn-gpp stg mcsvc samsung com/lib/wallet-card js" type="text/javascript"></script> <div id="target_id"></div> <script> samsungwallet addbutton { partnercode "4030093436155138240", cardid "3gna0sm71ts00", cdata "${card data as jwt}", rdclickurl "https //us-rd mcsvc samsung com/statistics/click/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641019830286;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093644822138240;li=0", rdimpressionurl "https //us-rd mcsvc samsung com/statistics/impression/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641019830286;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093644822138240;li=0", targetid "target_id", buttonid "button_id", } ; </script> id card <script src="https //us-cdn-gpp stg mcsvc samsung com/lib/wallet-card js" type="text/javascript"></script> <div id="target_id"></div> <script> samsungwallet addbutton { partnercode "4030093436155138240", cardid "3gna1lkrjvng0", cdata "${card data as jwt}", rdclickurl "https //us-rd mcsvc samsung com/statistics/click/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641019830286;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093644822138240;li=0", rdimpressionurl "https //us-rd mcsvc samsung com/statistics/impression/addtowlt?ep=c50c3754feb24833b30c10b275bb6ab8;cc=gc;ii=1287098641019830286;co=4030093436155138240;cp=1288017491089625089;si=24;pg=101212967375212546;pi=aqz68ebxsx6mv9jsazxzaa;tp=4030093644822138240;li=0", targetid "target_id", buttonid "button_id", } ; </script> paste the copied add to samsung wallet script into the index html file of the sample partner site then, add the attributes below, to the samsungwallet addbutton function target "wallet", showforced true target sets the button's name to samsung wallet "wallet" or samsung pay "pay" by default, the value is "wallet" showforced is a flag to show or hide the button by default, the button is hidden otherwise, set the flag value to true to know the samsung wallet or pay service availability for device and country, see check service available device noteincluding the javascript library in the head tag and adding the rest of the script to the body tag is recommended yet, it works if you paste it as is generate and input the cdata the add to samsung wallet script does not automatically include the cdata encrypted card data as it requires encryption for security purposes cdata is the actual content data of wallet card and it has several formats based on card type download the cdata generator and input your parner id you can use the sample cdata generator created to serve the purpose of this code lab only download the cdata generation sample code locate and open the downloaded file in intellij idea in the project folder, go to src > main > java > jwtgenerator java input your partner id as partner_code string value public class jwtgenerator { private static final string partner_id = "insert_your_partner_id"; //same with partnercode of add to samsung wallet script build your card data in jwtgenerator java, uncomment the plaindata that corresponds with your selected card type // boarding pass // string plaindata = new payloadutil "sample/payload/boardingpass json" getsampleboardingpass ; // coupon // string plaindata = new payloadutil "sample/payload/coupon json" getsamplecoupon ; // ticket // string plaindata = new payloadutil "sample/payload/ticket json" getsampleticket ; tipyou can modify the cdata generator to function according to your requirements for example, you can define the plaindata to load and process card data types other than boarding pass, ticket, and coupon go to resources > sample > payload and create a json file for your card data you can also use the card data builder created for this code lab to edit your chosen sample card copy the json format string to your json file after making your card data secure your wallet card next, go to resources > sample > securities add your private key partner key , partner certificate partner crt , and samsung certificate samsung crt in this directory to secure your wallet card partner private key a key required to use with partner certificate to sign card data this safe-keeping key can be created with certificate signing request csr when you joined the partner portal see encryption setting partner certificate a certificate required to sign or verify tokenized data it will be attached to the partner sign-up completion mail samsung certificate a certificate required to encrypt card data it will be attached to the partner sign-up completion mail for details about these security factors, see security input the cdata to add to samsung wallet script build the project right-click on jwtgenerator class and click run 'jwtgenerator main ' to create the cdata different cdata must be created for each of the sample partner sites of this code lab notethe generated cdata won't expire and can only be used for code lab testing cdata is valid only within 30 seconds after creation for security purposes in actual application lastly, go back to the index html of the chosen partner site and paste the generated cdata to the cdata attribute value of the addbutton sub-item test the add to samsung wallet button with the samsung wallet app, you can test the add to samsung wallet button functionality integrated into the sample partner sites directly on a mobile device access the url provided by codesandbox on samsung internet or any browser if your device does not support samsung wallet such as desktop, laptop, or tablet, you can scan the qr code to load the page on your galaxy device click the samsung wallet button in the sample partner site to add the card to the samsung wallet noteyou can see and monitor wallet card statistics by going to the portal's dashboard > wallet card statistics you're done! congratulations! you have successfully achieved the goal of this code lab topic now, you can integrate the add to samsung wallet with your website by yourself! if you're having trouble, you may check the complete code below boarding pass airlines boarding pass buses boarding pass trains ticket movies ticket sports ticket entrances coupon gift card loyalty card id card to learn more about samsung wallet, visit developer samsung com/wallet

membership, if you sign up with your samsung account and then further just to add, because we have such a good relationship with the samsung health team, all that data that you're doing, you can share between applications, you can have that sort of a large overview of your health profile within the samsung health application as well tony morelan 12 08 oh, that's wonderful so let's talk a bit about the development of the app what is the workflow? what is the process for you guys, when you created workout trainer? maria ly 12 17 i guess for starters, we use kind of agile development practices and a lot of brainstorming, we currently use android studio and we host all of our contents in the cloud and on top of that, obviously, we use the latest tools with within the samsung sdk id kind of environment tony morelan 12 40 sure, sure so when you first created the app, how long did it take? you know, is this an app that took, you know, a long time to create? or was this something that came pretty quickly and easily to you, maria ly 12 50 i would say that the first very early version of our app took about six months but as you guys know, app development is never as straightforward as you would like and you're always evolving your app and making it better and better and so throughout the years, we've added more features tightened up our flow improved our ui ux experience so you know, it all depends on what your app is aiming to do and offer, and try to use, you know, the best tools possible and rev on it and keep in mind that people like good user experience so even if it's a utility app, you have to think about your customers and get their feedback early on yeah, you tony morelan 13 33 know, the one thing that i will say about when i used to work at trainer was the ui was wonderful i mean, it's because you're in the middle of a workout and so you want something that is simple and easy to use with just a nice, clean interface and that's one of the things that stood out for me with workout trainer maria ly 13 47 well, thanks it's always a work in progress tony morelan 13 50 so let's talk about discoverability because i know that is one of the hardest parts i mean, it's one thing to go and create an app and build it and publish it but the hardest thing is to get people to actually see it and use it so what have you guys done related to discoverability? maria ly 14 05 for us, we have different channels to get discovered a lot of it has to do with be partners with certain discovery channels, but also with our community so for instance, you know, people can do workouts and invite their friends and challenge them to workouts so sort of creating that, like word of mouth has been very helpful for us get discovered through a grassroot approach and then also, you know, sometimes we have different partners where we can sell our app into verticals like within health care, or corporations, or specific areas, or times of the year for instance, samsung and symbols workout trainer can do sort of a collab or a promotion period tony morelan 14 55 yeah, yeah and i'm sure you guys are using the galaxy store badge is that correct to help promote it and weren't people directly to the app on galaxy store? yes, we are for sure wonderful and i'll make sure to include a direct link to that in the in the show notes for, not just that for, but for many of the other areas that we're talking about i loved what you said, as far as you know, inviting a friend and building that community because i know when it comes to workouts, a lot of times people don't have the motivation to do it themselves and they need to be held accountable so you know, if you find a friend that says, hey, if you work out all workout, and when you guys can work out together, you know, in sort of motivate each other to work out, that's what really gets you into a good routine as far as fitness so how many people would you say are using workout trainer, maria ly 15 43 we've seen over 30 million users come our way and, you know, on a day-to-day basis, we're seeing 10s of 1000s of workouts being completed and these are, you know, long form workouts so people are not just going into our app, and you know, jumping away, they're actually finding good content, relevant content for them to do and play for a long period of time, be it, you know, five to 20, to even, you know, 45 minutes long tony morelan 16 08 that's wonderful that is great and that is one of those key things when it comes to you for app developers, they want to create an experience where someone is not just coming in, you know, and like playing a game for a few minutes, and then they're gone retention is such a key component to creating a successful app how do you guys generate revenue, maria ly 16 29 we're going to trainer is a free application, and we offer in app purchase subscription that would be the pro plus membership option so that's offered at 699 a month and it's a reoccurring subscription and we also offer our one-on-one online training platform and the trainer sets the price and on average, it's between 50 to $200 a month, and we take a platform fee tony morelan 16 52 i love that that that you offer that that opportunity for people who want to really, you know, find that personal one on one trainer but yet your app also is available at an affordable price just for the general community i think that is that is great, because it makes it easy for people to give it a try and see if they like it and then decide maybe they want to, you know, get more involved with the app maria ly 17 13 oh, for sure and sometimes our trainers offer one on one training with free trials so we offer a free trial period as well tony morelan 17 19 oh, that's great that is that it's that's wonderful yeah so what advice would you give developers looking to bring their app to galaxy store? maria ly 17 29 oh, i would definitely encourage folks to get on the samsung platform because, as you guys know, around the world, like there are so many people that are using samsung devices, be it the smartphones, tablets, or the smartwatches and so being on the platform will just bring more visibility to your application and it's an opportunity to grow your user base naturally tony morelan 17 52 tell me what is in the future first gimble maria ly 17 55 so we've focused on creating great content and we're going to continue doing that working on providing a platform where people can access more multimedia content from trainer created content workouts created and led by your famous youtube fitness celebrities, and so forth so for us with workout trainer, we want to create and serve the best content for you so that personalized experience where you can have instant access to follow along content for your fitness journey tony morelan 18 28 that's, that's wonderful you know, this this past year, there's been a really big push for diversity and inclusion tell me what is kimble doing related to that? maria ly 18 38 i think from the start with scramble and growing our early team, i always wanted to have a group of great folks not just like industry, people, but trainers and everybody that has been involved to reflect the people who are actually using the application and so, you know, i was not specifically seeking out extreme diversity, but by just me wanting to talk to all kinds of folks from around the world trainers who had, you know, a focus on high intensity training versus pilates, yoga studio style backgrounds and we have so many different trainers demonstrating our exercises, our exercise database library, i believe has grown to be the largest out there with trainers who are very diverse, you know, they look like me and you and all the other folks who use the application so i hope that the application offers content that feels diverse in the type of content it provides, and also the friendly faces who are demonstrating the exercises tony morelan 19 47 that's great so recently, we did a blog feature on you for international women's day you know, being a woman leading a tech company tell me what advice would you give young women looking to start a career are in tech, maria ly 20 01 you know, more than ever before, women are breaking barriers so, you know, having their voices heard within tech within athletics within all sorts of fields, you know, having them be out there doing the work that they love living their best life and if that means, you know, being a leader in technology, or you know, a developer, an engineering manager, there are so many roles within tech that you could pursue and if you have an early appetite for some of the math and science classes, you know, a technology career could be for you so just pursue it and explore it, and you could be your own boss, even, there are so many opportunities now more than ever, i would say, where you can have the mentorship and support and encouragement from not just, you know, the leaders, the your male counterparts, the females in the space, who maybe have been there for a few years, even for me, you know, i do like advising and investing in women led companies in something that inspires me because i want to see the young females take charge and create amazing products for our future generation and, you know, my children even i'm excited for the future and what it can bring for all folks tony morelan 21 18 yeah, no, that's, that's wonderful in that blog, i'm going to link to it it was a great interview; you actually went into great detail on some of these areas that would really help inspire women and young women to really get started into this tech industry so maria, it was excellent to chat with you and learn much more about you know, workout trainer and all the great things that you guys are doing it's gimble let me ask you, what is it that you do for fun when you are not working? maria ly 21 45 well, i have two kids, they can be quite busy on my off hours, we are doing a lot of different activities for instance, over the weekend, i took my son to his first gymnastics class, and then we went skiing because we're in salt lake and it's the end of the season, he went out his first black even so just seeing the young guys, they're leading the charge there and i'm just trying to keep up in addition, when there's a little downtime, i do like to have some focus over for home cooked meal and a board game or two so i actually like playing strategy board games so that's one of my little-known passions as well tony morelan 22 25 that's wonderful that's wonderful i love a good time with friends, food and fun game activity well, hey, maria, it was great to have you on the podcast, i really enjoy you taking the time to chat maria ly 22 35 likewise, tony closing 22 37 looking to start creating for samsung download the latest tools to code your next app, or get software for designing apps without coding at all sell your apps to the world on the samsung galaxy store check out developer samsung com today and start your journey with samsung tony morelan 22 53 the samsung developers podcast is hosted by tony morelan and produced by jeanne hsu

membershipstatuslevel string 256 optional image url for the status level of the airline alliance or own membership i e , airline skyteam, star alliance image size 68x20 / 140x20 52 barcode value string 4096 optional barcode data, serial number 53 barcode serialtype string 32 optional presentation type e g , serialnumber, barcode, * see barcode format 54 barcode ptformat string 32 optional presentation format e g , barcode, qrcode, serial, *see barcode format 55 barcode ptsubformat string 32 optional presentation sub-format e g , code_128, qr_code, * see barcode format 56 barcode errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes * code options l/m/q/h example airline boarding pass { "card" { "type" "boardingpass", "subtype" "airlines", "data" [ { "refid" "se16138353212584800001", "createdat" 1612660039000, "updatedat" 1612660039000, "language" "en", "attributes" { "title" "oo air boarding pass", "transittype" "airline", "groupingid" "se867132687321", "providerlogo" "https // /logoimage png", "providerlogo darkurl" "https // /logoimage png", "providername" "oo air", "user" "gil dong hong", "vehiclenumber" "se123", "seatclass" "economy plus", "seatnumber" "a15", "reservationnumber" "a238473-1", "boardingseqno" "32", "boardingtime" 1612660039000, "boardingtime utcoffset" "utc+9", "baggageallowance" "15kg", "departname" "seoul/incheon", "departcode" "inc", "departterminal" "c", "departgate" "1", "estimatedoractualstartdate" 1612660039000, "estimatedoractualstartdate utcoffset" "utc+9", "arrivename" "san francisco", "arrivecode" "sfo", "arriveterminal" "a", "arrivegate" "11", "estimatedoractualenddate" 1612660039000, "estimatedoractualenddate utcoffset" "utc-8", "bgcolor" "#ff00ff", "fontcolor" "dark", "applinklogo" "https // /applinklogo png", "applinkname" "oo airline", "applinkdata" "https //www ooairline com", "csinfo" "{\"call\" \"555 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "barcode value" "cs16138353212584806754fg1802", "barcode serialtype" "barcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code" }, "localization" [ { "language" "ko", "attributes" { "title" "oo 항공 탑승권", "providername" "oo 항공", "user" "홍 길동" } } ] } ] } } grouped bus boarding passes { "card" { "type" "boardingpass", "subtype" "buses", "data" [ { "refid" "ref-202211300001", "createdat" 1669782394000, "updatedat" 1669782394000, "language" "en", "attributes" { "title" "samsung bus boarding pass", "transittype" "bus", "groupingid" "grp-20221130001", "providerlogo" "https // /logoimage png", "providerlogo darkurl" "https // /logoimagedark png", "providername" "samsung bus", "user" "galaxy kim", "usertype" "adult", "transitoperator" "samsung transport co ", "seatnumber" "7-a", "reservationnumber" "rsvno-202211300001", "transitclass" "premium", "transitfare" "12,500 won", "boardingtime" 1671926400000, "boardingtime utcoffset" "utc+09 00", "departname" "east-seoul bus terminal", "departgate" "14", "estimatedoractualstartdate" 1671928200000, "estimatedoractualstartdate utcoffset" "utc+09 00", "arrivename" "suwon bus terminal", "bgcolor" "#f1c232", "fontcolor" "dark", "applinklogo" "https // /applinklogo png", "applinkname" "samsung bus", "applinkdata" "https //www samsung-bus com", "csinfo" "{\"call\" \"555 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "barcode value" "161383532125848067541802", "barcode serialtype" "barcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code" }, "localization" [ { "language" "ko", "attributes" { "title" "삼성버스 탑승권", "providername" "삼성버스", "user" "김 은하", "transitfare" "12,500 원" } } ] }, { "refid" "ref-202211300002", "createdat" 1669782394000, "updatedat" 1669782394000, "language" "en", "attributes" { "title" "samsung bus boarding pass", "transittype" "bus", "groupingid" "grp-20221130001", "providerlogo" "https // /logoimage png", "providerlogo darkurl" "https // /logoimagedark png", "providername" "samsung bus", "user" "samsung sam", "usertype" "child", "transitoperator" "samsung transport co ", "seatnumber" "7-b", "reservationnumber" "rsvno-202211300002", "transitclass" "preminum", "transitfare" "9,000 won", "boardingtime" 1671926400000, "boardingtime utcoffset" "utc+09 00", "departname" "east-seoul bus terminal", "departgate" "14", "estimatedoractualstartdate" 1671928200000, "estimatedoractualstartdate utcoffset" "utc+09 00", "arrivename" "suwon bus terminal", "bgcolor" "#f1c232", "fontcolor" "#000000", "applinklogo" "https // /applinklogo png", "applinkname" "samsung bus", "applinkdata" "https //www samsung-bus com", "csinfo" "{\"call\" \"555 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "barcode value" "161383532125848067541802", "barcode serialtype" "barcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code" }, "localization" [ { "language" "ko", "attributes" { "title" "삼성버스 탑승권", "providername" "삼성버스", "user" "사만다 삼성", "transitfare" "9,000 원" } } ] } ] } } event ticket 'event ticket' cards support event commodities for performances, sports, movies, entrances, and etc event tickets in wallet can provide additional information about the event and an alarm before the event time and expiration ticket cards support event commodities for performances, sports, movies, and entrance wallet card type wallet card subtype ticket performances, sports, movies, entrances, others -performances -movies -sports -entrances type value description attributes {fields} 1 title string 32 required main title e g , mlb ticket 2 category string 16 optional ticket category * this will be deprecated 3 eventid string 32 optional if full cancelation of the event occurs, find and process all tickets with this id 4 groupingid string 32 optional identifier used to group related cards 5 orderid string 32 optional a unique identifier for an order 6 mainimg string 256 required url for main ticket image the file size should not exceed 512 kb 7 subtitle1 string 32 optional the auxiliary field which displays supporting information 8 logoimage string 256 required logo image url to be displayed in the card item the file size should not exceed 256 kb 9 logoimage darkurl string 256 required logo image url in dark mode the file size should not exceed 256 kb 10 logoimage lighturl string 256 required logo image url in light mode the file size should not exceed 256 kb 11 wideimage string 256 optional wide horizontal image url displayed on the card information screen the file size should not exceed 256 kb 12 providername string 32 required ticket provider name 13 providerviewlink string 512 optional link to additional information from the provider* see links format 14 classification string 16 optional classification of tickets use onetime, regular, or annual * default onetime 15 holdername string 64 optional name of card holders 16 idphoto string 200000 optional holder’s photo image data encoded base64 17 idphoto format string 32 optional image file formate g , jpeg, png * unsupported image formats may exist 18 idphoto status string 16 optional status of the dataallowed value unchanged 19 grade string 32 optional ticket grade 20 seatclass string 32 optional seat class 21 entrance string 64 optional entrance gate 22 seatnumber string 256 optional seat location 23 seatlayoutimage string 256 optional url of the seat layout image the file size should not exceed 512 kb 24 issuedate long 13 required issue date epoch timestamp in milliseconds 25 reservationnumber string 32 required reservation number 26 user string 64 optional name of person who made the reservation 27 certification string 16 optional ticket certification e g ,r, as a film rating 28 reactivatableyn string 1 optional flag whether the card is able to activate an expired ticket temporarily either 'y' or 'n' * default 'n' 29 preventcaptureyn string 1 optional flag whether this wallet card view prevents screen capture either 'y' or 'n'* default 'n' 30 nonetworksupportyn string 1 optional set whether to support to open the wallet card under 'no network' status either 'y' or 'n' * default 'n' 31 startdate long 13 required start date displayed start date epoch timestamp in milliseconds 32 enddate long 13 optional end date displayed end date epoch timestamp in milliseconds * if null, the card will expire in 10 hours from startdate 33 person1 string 512 optional number of persons by category * see classification format 34 locations string 1024 optional list of locations where the card can be used * see location format 35 noticedesc string 1024 required text of the notice * long content is allowed * see additional information format 36 groupinfo1 string 64 optional the first common information with the same groupingid 37 groupinfo2 string 64 optional the second common information with the same groupingid *it is recommended to set groupinfo1 first 38 groupinfo3 string 64 optional the third common information with the same 'groupingid' *it is recommended to set groupinfo1, groupinfo2 first 39 csinfo string 512 optional partners’ customer service information set value to json object call, email, website, sns * see the example below 40 privacymodeyn string 1 optional whether or not to require user authentication when using the cardeither ‘y’ or ‘n’* default ‘n’ 41 applinklogo string 256 required app link image url the file size should not exceed 256 kb 42 applinkname string 32 required app link name 43 applinkdata string 256 required information about the partner app link 44 bgcolor string 8 optional color of the card art e g , #00ffff 45 fontcolor string 8 optional color of the font on the card art acceptable values dark, light 46 blinkcolor string 8 optional color of the blinking effect in the indicator areae g , #00ffff 47 barcode value string 4096 optional barcode data, serial number 48 barcode serialtype string 32 optional presentation type e g , serialnumber, barcode * see barcode format 49 barcode ptformat string 32 optional presentation format e g , barcode, qrcode, serial * see barcode format 50 barcode ptsubformat string 32 optional presentation sub-format e g , code_128, qr_code * see barcode format 51 barcode errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes * code options l/m/q/h if coupons are provided together, samsung wallet can show up to two coupons per ticket 52 relcoupon1 title string 32 conditional 1st coupon title * required if this ticket has a related coupon 53 relcoupon1 subtitle string 32 optional 1st coupon subtitle 54 relcoupon1 providername string 32 conditional 1st coupon provider name * required if this ticket has a related coupon 55 relcoupon1 imagefilesrc string 256 optional 1st coupon image url the file size should not exceed 256 kb 56 relcoupon1 noticedescription string 1024 optional text of the notice * long content is allowed * see additional information format 57 relcoupon1 notificationtime long 13 optional coupon exposure time epoch timestamp in milliseconds 58 relcoupon1 value string 4096 conditional barcode data, serial number 59 relcoupon1 serialtype string 32 required presentation type e g , serialnumber, barcode * see barcode format 60 relcoupon1 ptformat string 32 conditional presentation formate g , barcode, qrcode, serial * see barcode format 61 relcoupon1 ptsubformat string 32 conditional presentation sub-formate g , code_128, qr_code * see barcode format 62 relcoupon1 errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes * code options l/m/q/h 63 relcoupon2 title string 32 conditional 2nd coupon title * required if this ticket has a related 2nd coupon 64 relcoupon2 subtitle string 32 optional 2nd coupon subtitle 65 relcoupon2 providername string 32 conditional 2nd coupon provider name * required if this ticket has a related 2nd coupon 66 relcoupon2 imagefilesrc string 256 optional 2nd coupon image url the file size should not exceed 256 kb 67 relcoupon2 noticedescription string 1024 optional text of the notice * long content is allowed * see additional information format 68 relcoupon2 notificationtime long 13 optional coupon exposure time epoch timestamp in milliseconds 69 relcoupon2 value string 4096 conditional barcode data, serial number 70 relcoupon2 serialtype string 32 required presentation type e g , serialnumber, barcode * see barcode format 71 relcoupon2 ptformat string 32 conditional presentation formate g , barcode, qrcode, serial * see barcode format 72 relcoupon2 ptsubformat string 32 conditional presentation sub-formate g , code_128, qr_code * see barcode format 73 relcoupon2 errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes * code options l/m/q/h example { "card" { "type" "ticket", "subtype" "entrances", "data" [{ "refid" "ent-ticket-0613001", "createdat" 1686657600000, "updatedat " 1686657600000, "language" "en", "attributes" { "title" "galaxy land entrance ticket", "subtitle1" "standard", "classification" "annual", "groupingid" "group-0613001", "orderid" "ent-0613001", "mainimg" "https // /main png", "logoimage" "https // /logo png", "providername" "galaxy entertainment", "logoimage darkurl" "https // /logo-dark png", "issuedate" 1686657600000, "reservationnumber" "glx-0613-001", "startdate" 1686657600000, "enddate" 1718280000000, "holdername" "kim eunha", "idphoto data" "base64-encoded{image-file-data}", "idphoto format" "png", "grade" "family", "person1" "{\"person\" [{\"category\" \"adult\", \"count\" 1 }]}", "locations" "[{\"lat\" 37 256518, \"lng\" 127 053516, \"address\" \"samsung-ro yeongtong-gu, suwon\", \"name\" \"galaxy land central park\"}]", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice 1\",\"content\" [\"description 1-1\",\"description 1-2\"]},{\"title\" \"notice 2\",\"content\" [\"description 2-1\"]}]}", "groupinfo1" "adult 1", "groupinfo2" "standard", "groupinfo3" "family", "csinfo" "{\"call\" \"555 123-4567\",\"email\" \"cs@email com\",\"website\" \"https //homepage com/cs\",\"facebook\" \"https //facebook com/cs\",\"instagram\" \"https //instagram com/cs\",\"youtube\" \"https //youtube com/cs\"}", "applinkname" "galaxy ticket", "applinklogo" "https // /applinklogo png", "applinkdata" "https //www applinkdata com", "bgcolor" "#e86d1f", "fontcolor" "light", "blinkcolor" "#e86d1f", "barcode value" "serial-0613-001", "barcode serialtype" "barcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code" }, "localization" [{ "language" "ko", "attributes" { "title" "갤럭시 랜드 입장권", "holdername" "김은하", "person1" "{\"person\" [{\"category\" \"어른\", \"count\" 1 }]}", "locations" "[{\"lat\" 37 256518, \"lng\" 127 053516, \"address\" \"samsung-ro yeongtong-gu, suwon\", \"name\" \"갤럭시 랜드 센트럴 파크\"}]", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"공지사항 1\",\"content\" [\"설명 1-1\",\"설명 1-2\"]},{\"title\" \"공지사항 2\",\"content\" [\"설명 2-1\"]}]}", "groupinfo1" "어른 1" } }] }] } } coupon 'coupon' cards support digitized redeemable voucher coupons in wallet for various channels can provide alarms before expiration and update usage status wallet card type wallet card subtype coupon others type value description attributes {fields} 1 title string 32 required main title e g , free coupon 2 orderid string 32 optional unique identifier for an order 3 mainimg string 256 required url for the main coupon image the file size should not exceed 512 kb 4 brandname string 32 optional brand name 5 expiry long 13 required expiration date in timestamp format issued data is cleaned up after it expires epoch timestamp in milliseconds 6 issuedate long 13 required issue date epoch timestamp in milliseconds 7 redeemdate long 13 optional date when the coupon is used epoch timestamp in milliseconds 8 noticedesc string 1024 optional text of notice * html is supported 9 editableyn string 1 required flag whether the coupon can be modified either 'y' or 'n' 10 deletableyn string 1 required flag whether the coupon can be deleted either 'y' or 'n' 11 displayredeembuttonyn string 1 required flag whether the use completion button is displayed either 'y' or 'n' 12 notificationyn string 1 required flag whether a notification related to the coupon is delivered either 'y' or 'n' 13 applinklogo string 256 required app link image url the file size should not exceed 256 kb 14 applinkname string 32 required app link name 15 applinkdata string 256 required information about the partner app link 16 preventcaptureyn string 1 optional flag whether this wallet card view prevents screen captureeither 'y' or 'n'* default 'n' 17 barcode value string 4096 conditional barcode data, serial number * required if serialtype is other than 'none' 18 barcode value2 string 4096 conditional the secondary barcode data * required if ptformat is dualbarcode or dualbarcodeserial 19 barcode serialtype string 32 optional presentation type e g ,serialnumber, barcode * see barcode format 20 barcode ptformat string 32 optional presentation format e g , barcode, qrcode, serial * see barcode format 21 barcode ptsubformat string 32 optional presentation sub-format e g ,code_128, qr_code * see barcode format 22 barcode errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes * code options l/m/q/h 23 balance string 32 optional initial balance this is going to be shown as received it is recommended to use a one letter currency symbol e g , $1,000, 1,000p 24 summaryurl string 256 optional webpage url that show details, such as balance 25 usermessage string 256 optional message to forward 26 sender string 64 optional name of sender example { "card" { "type" "coupon", "subtype" "others", "data" [{ "refid" "ref-230712-0001", "createdat" 1612660039000, "updatedat" 1612660039000, "language" "en", "attributes" { "title" "free coupon", "mainimg" "https // /main png", "brandname" "samsung coupon", "expiry" 1637802725000, "issuedate" 1637457125000, "editableyn" "n", "deletableyn" "n", "displayredeembuttonyn" "y", "notificationyn" "y", "applinkname" "oo voucher", "applinklogo" "https // /applinklogo png", "applinkdata" "https //www oocoupon com", "barcode value" "cs16138353212584806754fg1802 ", "barcode serialtype" "barcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code" } }] } } gift card 'gift card' cards support enrolling prepaid cards also known as gift certificate, gift voucher or gift token links urls to get balance and transactions history in real time is provided in the partners portal if a partner needs to integrate communication between samsung wallet server and the partner’s server to support the feature, the partner has to set the links in partners portal wallet card type wallet card subtype giftcard others type value description attributes {fields} 1 title string 32 required main title e g , samsung gift card 2 eventid string 36 optional if full cancelation of the event occurs, find and process all gift cards with this id 3 orderid string 36 optional a unique identifier for an order 4 subtitle1 string 32 optional the auxiliary field which displays supporting information 5 logoimage string 256 optional logo image url to be displayed in the card item the file size should not exceed 256 kb 6 logoimage darkurl string 256 optional logo image url in dark mode the file size should not exceed 256 kb 7 logoimage lighturl string 256 optional logo image url in light mode the file size should not exceed 256 kb 8 providername string 32 required gift card provider name 9 user string 64 optional name of person who holds the gift card 10 preventcaptureyn string 1 optional flag whether this wallet card view prevents screen capture either 'y' or 'n', the default value is 'n' 11 startdate long 13 optional start date display start date epoch timestamp in milliseconds 12 enddate long 13 optional end date display end date epoch timestamp in milliseconds 13 locations string 1024 optional list of locations where the gift card can be used * see location format 14 noticedesc string 1024 optional text of the notice * long content is allowed * see additional information format 15 csinfo string 512 optional set value to json object call, email, website * see the example below 16 applinklogo string 256 required app link image url the file size should not exceed 256 kb 17 applinkname string 32 required app link name 18 applinkdata string 256 required information about the partner app link 19 bgimage string 256 optional url for card art background image 20 mainimg string 256 optional url for gift card image the file size should not exceed 512 kb 21 bgcolor string 8 optional color of the card art e g ,#00ffff 22 fontcolor string 8 optional color of the font on the card art acceptable values dark, light 23 blinkcolor string 8 optional color of the blinking effect which indicates that a card cannot be captured in the indicator area e g , #00ffff 24 barcode value string 4096 optional barcode data, serial number 25 barcode serialtype string 32 optional presentation type e g , serialnumber, barcode *see barcode format 26 barcode ptformat string 32 optional presentation format e g , barcode, qrcode, serial *see barcode format 27 barcode ptsubformat string 32 optional presentation sub-format e g , code_128, qr_code * see barcode format 28 barcode pin string 16 optional pin to show with a barcode 29 barcode errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes * code options l/m/q/h 30 merchantid string 36 optional merchant identifier 31 merchantname string 32 optional merchant name to display 32 amount string 32 optional initial balance this is going to be shown as received e g , $1,000 33 balance string 32 optional remaining balance this is going to be shown as received e g , $1,000 34 summaryurl string 256 optional web url that show details, such as balance or transactions history example { "card" { "type" "giftcard", "subtype" "others", "data" [ { "refid" "b3fdc982-28c9-47a3-b02f-d484779698a7", "createdat" 1672574400000, "updatedat" 1672574400000, "language" "en", "attributes" { "title" "samsung gift card", "eventid" "event-001", "logoimage" "https //gpp walletsvc samsung com/mcs/images/contents/wallet_intro_logo png", "logoimage darkurl" "https //gpp walletsvc samsung com/mcs/images/contents/wallet_intro_logo png", "providername" "samsung gift card provider", "user" "ms jane doe", "noticedesc" "<ul><li>gift card test</li></ul>", "csinfo" "{\"call\" \"555 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "applinklogo" "https //play-lh googleusercontent com/znfa1roz7hpv9j-jiacbjmjudl2x-fnuwte0oyvbbcwvf5vpzoqqikbxgk7d-aptvag=w240-h480-rw", "applinkname" "gift card link", "applinkdata" "https //www samsung com/", "bgcolor" "#0a1a4f", "fontcolor" "light", "blinkcolor" "#00ffff", "barcode value" "cs16138353212584806754fg1802", "barcode serialtype" "qrcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code" } } ] } } loyalty 'loyalty' cards support enrolling loyalty cards also known as membership links urls to get points in real time can be provided in the partners portal if a partner needs to integrate communication between samsung wallet server and the partner’s server to support the feature, the partner has to set the links in the partners portal wallet card type wallet card subtype loyalty others type value description attributes {fields} 1 title string 32 required main title e g ,samsung loyalty card 2 eventid string 36 optional if full cancelation of the event occurs, find and process all loyalty cards with this id 3 groupingid string 36 optional identifier used to group related cards 4 orderid string 36 optional a unique identifier for an order 5 mainimg string 256 optional url for main loyalty card image the file size should not exceed 512 kb 6 subtitle1 string 32 optional the auxiliary field which displays supporting information 7 logoimage string 256 optional logo image url to be displayed in the card item the file size should not exceed 256 kb 8 logoimage darkurl string 256 optional logo image url in dark mode the file size should not exceed 256 kb 9 logoimage lighturl string 256 optional logo image url in light mode the file size should not exceed 256 kb 10 providername string 32 required loyalty card provider name 11 preventcaptureyn string 1 optional flag whether this wallet card view prevents screen capture either 'y' or 'n', the default value is 'n' 12 startdate long 13 optional start date display start date epoch timestamp in milliseconds 13 enddate long 13 optional end date display end date epoch timestamp in milliseconds 14 locations string 1024 optional list of locations where the card can be used * see location format 15 noticedesc string 1024 optional text of the notice * long content is allowed * see additional information format 16 csinfo string 512 optional set value to json object call, email, website or social media which supports facebook, pinterest, x twitter and instagram * see the example below 17 applinklogo string 256 required app link image url the file size should not exceed 256 kb 18 applinkname string 32 required app link name 19 applinkdata string 256 required information about the partner app link 20 bgimage string 256 optional background image for a card art 21 bgcolor string 8 optional color of the card art e g , #00ffff 22 fontcolor string 8 optional color of the font on the card art acceptable values dark, light 23 blinkcolor string 8 optional color of the blinking effect which indicates that a card cannot be captured in the indicator area e g , #00ffff 24 barcode value string 4096 optional barcode data, serial number 25 barcode serialtype string 32 optional presentation type e g , serialnumber, barcode * see barcode format 26 barcode ptformat string 32 optional presentation format e g , barcode, qrcode, serial * see barcode format 27 barcode ptsubformat string 32 optional presentation sub-format e g , code_128, qr_code *see barcode format 28 barcode errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes * code options l/m/q/h 29 merchantid string 36 optional merchant identifier 30 merchantname string 32 optional merchant name to display 31 amount string 32 optional total amount of points or initial balance this is going to be shown as received it is recommended to use a one letter currency symbol e g , $ 1,000, 1,000p 32 balance string 32 optional available points or remaining balance this is going to be shown as received it is recommended to use a one letter currency symbol e g , $ 1,000, 1,000p 33 summaryurl string 256 optional webpage url that shows details, such as balance or transactions history example { "card" { "type" "loyalty", "subtype" "others", "data" [{ "refid" "b3fdc982-28c9-47a3-b02f-d484779698a8", "createdat" 1672574400000, "updatedat" 1672574400000, "language" "en", "attributes" { "title" "samsung loyalty card", "eventid" "event-001", "logoimage" "https //gpp walletsvc samsung com/mcs/images/contents/wallet_intro_logo png", "logoimage darkurl" "https //gpp walletsvc samsung com/mcs/images/contents/wallet_intro_logo png", "providername" "samsung loyalty card provider", "noticedesc" "<ul><li>loyalty card test</li></ul>", "csinfo" "{\"call\" \"555 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "applinklogo" "https //play-lh googleusercontent com/znfa1roz7hpv9j-jiacbjmjudl2x-fnuwte0oyvbbcwvf5vpzoqqikbxgk7d-aptvag=w240-h480-rw", "applinkname" "loyalty card link", "applinkdata" "https //www samsung com/", "bgcolor" "#0a1a4f", "barcode value" "cs16138353212584806754fg1802", "barcode serialtype" "qrcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code", "amount" "1,000p", "balance" "500p" } } ] } } id card 'id card' cards are used to present identification for employees, students, drivers, guests, etc wallet card type wallet card subtype idcard employees, nationals, students, drivers, guests, others type value description attributes {fields} 1 title string 32 required main title of cardse g , commercial access, employee badge 2 holdername string 64 required name of card holders 3 secondholdername string 64 optional second name of card holders 4 organization string 64 optional organization of card holders belongingi e , name of department, division, affiliation, association or team 5 position string 64 optional position of card holders 6 identifier string 64 required unique id value 7 idnumber string 64 optional representative value for an idi e , id number, document number 8 address string 256 optional address of card holders 9 placeoflocation string 64 optional place of location associated with the cardholder 10 idphoto string 128k optional holder’s photo image data encoded base64the file size should not be greater than 128 kb 11 idphoto format string 32 optional image file formate g , jpeg, png* unsupported image formats may exist 12 idphoto status string 16 optional status of the dataallowed value unchanged 13 document string 1024k optional first document of identity 14 document format string 32 optional document format- allowed value pdf, jpeg, png 15 document status string 16 optional status of the dataallowed value unchanged 16 provisioningtype string 16 optional a value indicating how to provision content that affects card featuresallowed value sdk, ese, usim, token 17 provisioningfactor string 512 optional elements to complete provisioning 18 issuedate long 13 required issue date epoch timestamp in milliseconds 19 birthdate string 16 optional date of birth 20 gender string 16 optional gender of card holders 21 classification string 16 optional classified identity type 22 expiry long 13 optional expiry date in timestamp format issued data is cleaned up after it expires epoch timestamp in milliseconds 23 contacts string 32 optional personal contact information such as phone number 24 uiccid string 32 optional universal ic card id * deprecated 25 logoimage string 256 optional logo image url to be displayed in card item the file size should not exceed 256 kb 26 logoimage darkurl string 256 optional logo image url in dark mode the file size should not exceed 256 kb* if this value does not exist, logoimage will be substituted 27 logoimage lighturl string 256 optional logo image url in light mode the file size should not exceed 256 kb* if this value does not exist, logoimage will be substituted 28 logotext string 16 optional text as an alternative to logoimage 29 providername string 32 required content provider name 30 issuername string 32 optional place of issue or issuing authority name 31 extrainfo string 512 optional additional information* see additional information format 32 noticedesc string 1024 optional text of the notice * long content is allowed * see additional information format 33 csinfo string 512 required set value to json object call, email, website * see the example below 34 privacymodeyn string 1 optional whether or not to require user authentication when using the card either ‘y’ or ‘n’* default ‘n’ 35 applinklogo string 256 optional app link image url the file size should not exceed 256 kb 36 applinkname string 32 optional app link name 37 applinkdata string 256 optional information about the partner app link 38 locations string 1024 optional list of locations where the card can be used* see location format 39 coverimage string 256 optional card cover image url the file size should not exceed 512 kb 40 bgimage string 256 optional card background image url the file size should not exceed 512 kb 41 bgcolor string 8 optional color of the card art support hex color code e g , #015aaa 42 fontcolor string 8 optional color of the font on the card art allowed value black, white 43 blinkcolor string 8 optional color of the blinking effect in the indicator area support hex color code e g , #015aaa 44 preventcaptureyn string 1 optional flag whether this wallet card view prevents screen capture either 'y' or 'n' * default 'n' 45 barcode value string 4096 optional barcode data, serial number 46 barcode serialtype string 32 optional presentation type e g , serialnumber, barcode, * see barcode format 47 barcode ptformat string 32 optional presentation format e g , barcode, qrcode, serial, * see barcode format 48 barcode ptsubformat string 32 optional presentation sub-format e g , code_128, qr_code, * see barcode format 49 barcode errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes - code options l/m/q/h * default l 50 barcode interval string 4 optional update interval if support for dynamic updates epoch timestamp in milliseconds example * employee id card { "card" { "type" "idcard", "subtype" "employees", "data" [{ "refid" "20000130003", "createdat" 1658385817000, "updatedat" 1658385817000, "language" "en", "attributes" { "title" "employee id card", "holdername" "kim samsung", "secondholdername" " samsung ", "organization" "digital wallet, mx", "position" "professional", "identifier" "2306070003", "idphoto" "{base64 encoded image data}", "idphoto format" "jpeg", "issuedate" "1658385817000", "expiry" "1765855665000", "logoimage" "https // /logo png", "providername" "mobile id", "extrainfo" “{\"count\" 1,\"info\" [{\"title\" \"shortcode\",\"content\" [\"404457\"]}]} ", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice1\",\"content\" [\"description1\",\"description2\"]},{\"title\" \"notice2\",\"content\" [\"description1\",\"description2\"]}]}", "csinfo" "{\"call\" \"555 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "applinkname" "mobile id one", "applinklogo" "https // /applinklogo png", "applinkdata" "https //www applinkorweblink com", "coverimage" "https // /card/cover png", "bgimage" "https // /card/background png", "fontcolor" "#000000" }, "localization" [{ "language" "ko", "attributes" { "title" "사원증", "holdername" "김삼성", "secondholdername" "kim samsung", "providername" "모바일 아이디", "extrainfo" "{\"count\" 1,\"info\" [{\"title\" \"접근 권한\",\"content\" [\"지역1\",\"지역2\"]}]}" } }] }] } } * national id card { "card" { "type" "idcard", "subtype" "nationals", "data" [{ "refid" "identitycard-bpo1r3e5-3313-0991-z404-sq12994414u8", "createdat" 1658385817000, "updatedat" 1658385817000, "language" "en", "attributes" { "title" "national id card", "holdername" "kim samsung", "secondholdername" " samsung ", "organization" "digital wallet, mx", "position" "professional", "identifier" "2306070003", "idphoto" "{base64 encoded image data}", "idphoto format" "jpeg", "document" "{base64 encoded pdf data}", "document format" "pdf", "issuedate" "1658385817000", "expiry" "1765855665000", "logoimage" "https // /logo png", "provisioningtype" "token", "provisioningfactor" "eyjhbgcioijiuzi1niisinr5cci6ikpxvcj9 eyjzdwiioiixmjm0nty3odkwiiwibmftzsi6ikpvag4grg9liiwiawf0ijoxnte2mjm5mdiyfq sflkxwrjsmekkf2qt4fwpmejf36pok6yjv_adqssw5c", "providername" "samsung electronics", "extrainfo" "{\"count\" 1,\"info\" [{\"title\" \"shortcode\",\"content\" [\"404457\"]}]}", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice1\",\"content\" [\"description1\",\"description2\"]},{\"title\" \"notice2\",\"content\" [\"description1\",\"description2\"]}]}", "csinfo" "{\"call\" \"555 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "applinkname" "samsung electronics", "applinklogo" "https // /applinklogo png", "applinkdata" "https //www applinkorweblink com", "coverimage" "https // /card/cover png", "bgimage" "https // /card/background png", "fontcolor" "#000000", "barcode value" "5728306720836720763017601", "barcode serialtype" "qrcode", "barcode ptformat" "qrcode", "barcode ptsubformat" "qr_code", "barcode interval" "300000" }, "localization" [{ "language" "ko", "attributes" { "title" "신분증", "holdername" "김삼성", "secondholdername" "kim samsung", "providername" "삼성전자" } }] }] } } generic card 'generic card' is defined for registering various forms of cards that aren't defined as other types partners can customize the items on the generic card to display by connecting them with card data wallet card type wallet card subtype generic others type value description attributes {fields} 1 title string 32 required main title 2 subtitle string 32 optional the auxiliary field which displays supporting information 3 providername string 32 required provider name 4 eventid string 32 optional event identifier 5 groupingid string 32 optional identifier used to group related cards 6 startdate long 13 required start date display start date epoch timestamp in milliseconds 7 startdate relativenotitime string 4 optional the relative time from startdate in minutes to provide a notification to the usere g , 5, 10, 15, 30, 60, and up to 2880 8 enddate long 13 optional end date display end date epoch timestamp in milliseconds 9 enddate relativenotitime string 4 optional the relative time from enddate in minutes to provide a notification to the usere g , 5, 10, 15, 30, 60, and up to 2880 10 mainimg string 256 required url for main image the file size should not exceed 512 kb 11 logoimage string 256 optional logo image url to be displayed in card item the file size should not exceed 256 kb 12 logoimage darkurl string 256 optional logo image url in dark mode the file size should not exceed 256 kb* if this value does not exist, logoimage will be substituted 13 logoimage lighturl string 256 optional logo image url in light modethe file size should not exceed 256 kb* if this value does not exist, logoimage will be substituted 14 coverimage string 256 optional card cover image urlthe file size should not exceed 512 kb 15 bgimage string 256 optional card background image urlthe file size should not exceed 512 kb 16 text{i} string 64 optional text item i 1~15 17 image{i} string 128k optional image item i 1~5 18 image{i} lighturl string 256 optional image item in light mode 19 image{i} darkurl string 256 optional image item in dark mode 20 image{i} status string 16 optional image item status 21 timestamp{i} long 13 optional timestamp item i 1~5 22 timestamp{i} utcoffset string 8 optional utc offset of timestamp 23 serial{i} string 4096 optional serial item i 1~2 24 serial{i} serialtype string 32 optional presentation typee g , serialnumber, barcode, * see barcode format 25 serial{i} ptformat string 32 optional presentation formate g , barcode, qrcode, serial, * see barcode format 26 serial{i} ptsubformat string 32 optional presentation sub-formate g , code_128, qr_code, * see barcode format 27 serial{i} errorcorrectionlevel string 4 optional amount of redundancy or error correction data included in the code there are four error correction levels available in qr codes - code options l/m/q/h 28 noticedesc string 1024 required notice description * long content is allowed * see additional information format 29 csinfo string 512 optional cs informationset value to json object calls or emails or websites * see below for an example 30 providerviewlink string 512 optional link to additional information from the provider* see links format 31 privacymodeyn string 1 optional whether or not to require user authentication when using the cardeither ‘y’ or ‘n’* default ‘n’ 32 bgcolor string 8 optional color of the card art e g , #00ffff 33 fontcolor string 8 optional color of the font on the card art acceptable values dark, light 34 blinkcolor string 8 optional color of the blinking effect in the indicator areae g , #00ffff 35 preventcaptureyn string 1 optional flag whether this wallet card view prevents screen capture either 'y' or 'n'* default 'n' 36 nonetworksupportyn string 1 optional sets whether to support to open the wallet card under 'no network' status either 'y' or 'n'* default 'n' 37 applinklogo string 256 required app link image url the file size should not exceed 256 kb 38 applinkname string 32 required app link name 39 applinkdata string 256 required information about the partner app link 40 locations string 1024 optional list of locations where the card can be used * see location format example { "card" { "type" "generic", "subtype" "others", "data" [{ "createdat" 1661745824345, "updatedat" 1661745824345, "language" "en", "refid" "refid-012345", "attributes" { "title" "samsung generic card", "subtitle" "personal members", "providername" "samsung", "startdate" 1661751274000, "startdate utcoffset" "utc+9", "enddate" 1761778000000, "enddate utcoffset" "utc+9", "enddate relativenotitime" "1440", "text1" "13047623", "text2" "silver", "text3" "suwon station branch", "text4" "031 000-1235", "timestamp1" 1761751274000, "timestamp1 utcoffset" "utc+9", "mainimg" "https //www samsung com/images/main png", "image1" "https //www samsung com/images/image1 png", "image1 darkurl" "https //www samsung com/images/dark png", "image1 lighturl" "https //www samsung com/images/light png", "serial1 value" ">1180mm2241b7c 0000000000000298060000000000 0 090870907 ", "serial1 serialtype" "qrcode", "serial1 ptformat" "qrcode", "serial1 ptsubformat" "qr_code", "bgcolor" "#ff5000", "fontcolor" "light", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice1\",\"content\" [\"description1\",\"description2\"]},{\"title\" \"notice2\",\"content\" [\"description1\",\"description2\"]}]}", "csinfo" "{\"calls\" [{\"emergency\" \"555 123-4567\"},{\"customer service\" \"555 123-9876\"}],\"emails\" [{\"cs team\" \"cs@atwsample com\"}],\"websites\" [{\"faq\" \"https //atwhomepage com/faq\"},{\"support\" \"https //atwhomepage com/support\"}]}", "providerviewlink" "{\"count\" 1,\"info\" [{\"link\" \"https //samsung external info link/refid-012345\",\"type\" \"web\",\"text\" \"see more information\"}]}", "applinkdata" "https //www samsung com/", "applinklogo" "https //www samsung com/logo png", "applinkname" "samsung" }, "localization" [{ "language" "ko", "attributes" { "title" "삼성 제네릭 카드", "subtitle" "개인 멤버스", "providername" "삼성", "text2" "실버 등급", "text3" "수원역점" } }] }] } }

membership is approved, typically within 2 business days, return to https //pay samsung com/developers, click sign in and enter your samsung account id and password for site access as a new member registering your domain for the w3c service your domain is the url associated with your website, whether in test or production the service type specifically associates w3c with your domain once you create the service, you will be prompted to configure the domain you want associated with it to create a new service go to my projects > service management and click create a new service select for test to define the service for initial integration with samsung pay, then click next select w3c mobile web payments as the service type and click next enter a service name and select “united states” as the service country select a payment gateway from the list of supported pgs if your payment gateway uses the network token mode, upload the certificate signing request csr you obtained from your pg supported formats are csr or pem contact your pg for details otherwise, key management is already established for pgs supporting samsung pay’s gateway token mode; hence, click connect with to create a new service connection with the pg and click ok enter the payment domain name s for your website in the service domain field and click add for example, if your domain is mywebstore com but the checkout page is hosted on the subdomain payments mywebstore com, you’ll need to enter payments mywebstore com as the service domain in the portal for each additional domain name, click add notewhen entering the domain name on the portal, do not include an https // prefix confirm your agreement with the terms and conditions, then click next adding w3c payment requests objects to your website in order to accept payments from samsung pay, your website must adhere to the w3c payment request api specification you can get started with the basics by completing the steps that follow and making the appropriate substitutions for your website step 1 feature detect prior making a w3c payment request, it’s wise to run a feature detect to ensure the browser in use supports the w3c payment request api if not, you should fall back to your traditional/normal checkout page example if window paymentrequest { // use payment request api } else { // fallback to traditional checkout window location href = ‘/checkout/traditional’; } step 2 create the paymentrequest constructor the first step is to create a paymentrequest object by calling the paymentrequest constructor, which has the following parameters methoddata – contains a list of payment methods that the website supports e g , visa, amex, samsung pay details – contains information about the shopping cart purchases e g , total, tax, fees, etc options – details pertaining to shipping address, user contact information, etc example var request = new paymentrequest methoddata, // required payment method data details, // required information about transaction options // optional parameter for things like shipping, etc ; step 3 add samsung pay to the methoddata parameter the methoddata parameter contains a list of payment methods supported by the merchant to support samsung pay, you’ll need to add it as a supported payment method notebasic-card is an optional supportedmethod for credit and debit cards saved in the browser, the card details of which are returned directly to the website from the browser before configuring this method, make sure your website and pg can handle generic payment information received from the browser and process with required pci compliance, if applicable see the [w3c basic card payment specification][7] for additional details be aware, however, that if you intend to support a branded samsung pay button, only samsung pay can be enabled as a payment method within the paymentrequest object; basic-card or any other payment method cannot be included if you already offer a generic payment request method, you can continue to do so — and include samsung pay as a payment method within that paymentrequest object from a user experience standpoint, the two distinct pathways look like this standard w3c implementation a standard w3c implementation adds samsung pay to your standard paymentrequest object as one of many supportedmethods available for user selection tapping checkout or its equivalent launches the standard browser payment sheet for user selection of the payment method and/or to add a debit/credit card to the list of options selecting samsung pay as the payment method and tapping pay launches the samsung pay payment sheet branded samsung pay implementation a branded implementation displays a "buy with samsung pay" button in place of your standard checkout button tapping the button will skip directly to the samsung pay payment sheet for authentication unless you specify paymentoptions if paymentoptions is not null, the browser payment sheet is launched see paymentoptions in step 7 for additional guidance first launching your website's checkout page is recommended for branded implementations this is because the samsung pay payment sheet only provides the user's billing address, which means your website will need to capture the user's preferred shipping address, where applicable for physical delivery of purchased goods if no shipping address and/or other options are needed, set the paymentoptions parameter to null as mentioned above, if you populate paymentoptions, the browser payment sheet is automatically launched keeping the foregoing implementations in mind, let's look at how to construct the methoddata argument for the network token mode and gateway token mode, respectively the fields in methoddata comprise supportedmethods – required; specifies https //spay samsung com/ i e , the samsung pay app and other methods suppored by your website data – values specific to the method; for samsung pay, these include version specifies the data structure being used by the merchant; should always be set to 1 until further notice required productid the service id obtained from the samsung pay partner portal required for partner verification; see step #8 under registering your domain for the w3c service merchantgatewayparameter this is the userid value registered with your pg required for gateway token mode in addition, userid should be set in the request parameter for mada token if a merchan request mada token, this field is mandatory as this filed should be included in the payload for mada token, there is a 15-character length limit paymentprotocol defaults to “protocol_3ds,” the only protocol currently supported by samsung pay optional allowedcardnetworks specifies the card brands/networks accepted by the merchant and supported by the pg required merchantname the name of the merchant to be displayed on the payment sheet; must be identical to the merchant name registered on the samsung pay partner portal required ordernumber unique value for merchant use as an external reference id optional isrecurring specifies transaction on subscription basis optional; default = false billingaddressrequired determines if a billing address must be filled-in by the user optional; default = false shown next are examples of the methoddata parameter for each of the supported token modes please note that samsung pay's w3c support for card brands is currently limited to mastercard, visa and american express discover is scheduled for support soon example – network token mode var methoddata = [ { supportedmethods ['https //spay samsung com'], data { 'version' '1', // always 1 until further notice 'productid' '2bc3e6da781e4e458b18bc', // service id from partner portal 'allowedcardnetworks' ['mastercard','visa'], 'merchantname' 'shop samsung demo ', // merchantname must be identical to merchant name on portal 'ordernumber' '1233123', } }] example – gateway token mode var methoddata = [ { supportedmethods ['https //spay samsung com'], data { 'version' '1', // always 1 until further notice 'productid' '7qr7h9ws1872bc3e6da781', // service id from partner portal 'merchantgatewayparameter' {"userid" "acct_ 17irf7f6ypzj7wor"}, 'allowedcardnetworks' ['mastercard','visa'], 'merchantname' 'shop samsung demo ', //merchantname must be identical with merchant name on portal 'ordernumber' '1233123', } }] step 4 fill out the transaction details parameter the details parameter contains information about the transaction there are two major components a total, which reflects the total amount and currency to be charged, and an optional set of displayitems that indicate how the final amount was calculated this parameter is not intended to be a line-item list, but is rather a summary of the order’s major components subtotal, discounts, tax, shipping costs, etc example var details = { displayitems [ { label "total of all items", amount { currency "usd", value "65 00" }, // us$65 00 }, { label "friends & family discount", amount { currency "usd", value "-10 00" }, // -us$10 00 pending true // the price is not yet determined } ], total { label "total", amount { currency "usd", value "55 00" }, // us$55 00 } } step 5 check eligibility to display samsung pay button if you do not support basic-card and you try to call show in step 6 when samsung pay or any other supportedmethod is not present on the device, the returned promise will reject with the following error domexception the payment method is not supported you can, however, check beforehand to see if the user has an available/supported method set up this is done with the canmakepayment method, which tells you whether the user has a payment method that can fulfill the current payment request example – canmakepayment const paymentrequest = new paymentrequest supportedpaymentmethods, transactiondetails, options ; // if canmakepayment isn’t available, default to assume the method is supported const canmakepaymentpromise = promise resolve true ; // feature detect canmakepayment if request canmakepayment { canmakepaymentpromise = paymentrequest canmakepayment ; } canmakepaymentpromise then result => { if !result { // the user does not have a supported payment method // todo redirect to traditional checkout flow return; } // todo the user has a payment - call show } catch err => { // todo either fall back to traditional checkout or call show } ; notebranded samsung pay buttons can be found on the [samsung pay developers][8] portal under the resources tab direct cdn links will be available soon step 6 call the show method to display the payment sheet the payment sheet can be activated by calling its show method this method invokes the browser’s native ui so the user can examine the details of the purchase, add or change the information, and submit it for payment a promise, indicated by its then method and callback function, resolves what will be returned when the user accepts or rejects the payment request example – show request show then function paymentresponse { // process paymentresponse here paymentresponse complete "success" ; } catch function err { console error "uh oh, something bad happened", err message ; } ; step 7 handle the paymentresponse once the user approves the payment request by verifying the payment option and shipping option if provided , the show method’s promise resolves, resulting in a paymentresponse object comprised of the following fields methodname string indicating the chose payment method e g , visa details dictionary containing information for methodname shippingaddress shipping address of the user, if requested shippingoption id of the selected shipping option, if requested payeremail email address of the payer, if requested payerphone telephone number of the payer, if requested payername name of the payer, if requested here, it’s important to remember that the response from the payment request api must be submitted by the merchant in accordance with the pg’s integration model and apis in all cases, the samsung pay response is encapsulated within the paymentresponse details parameter, which comprises the following fields paymentcredential – contains the payment credential information necessary for processing the transaction with the pg in network token mode, this field includes 3ds data in gateway token mode, it includes token information network token mode type use “s” version 1 0 0; standard for payment authentication aka mastercard securecode, verified by visa, and american express safekey data encrypted payload value gateway token mode reference token id reference status authorized or rejected/declined billingaddress – contains the billing address and related attributes for the cardholder, possibly including country [iso3166] alpha-2 code; canonical form is upper case for example, “us” addressline[n] most specific part of the address; can include a street name, a house number, apartment number, a rural delivery route, descriptive instructions, or a post office box number region top level administrative subdivision of the country; can be a state, a province, an oblast, or a prefecture city city/town portion of the address dependentlocality dependent locality or sub-locality within a city; fused for neighborhoods, boroughs, districts, or uk dependent localities postalcode postal code or zip code, also known as pin code in india sortingcode bank sorting code; for example, in the british and irish banking industries, the sort code is a six-digit number, is usually formatted as three pairs of numbers, for example 12-34-56, identifying both the bank and the branch where the account is held languagecode [bcp47] language tag for the address, in canonical form; used to determine the field separators and the order of fields when formatting the address for display organization organization, firm, company, or institution at this address recipient name of the recipient or contact person this member may, under certain circumstances, contain multiline information; for example, it might contain “care of” information phone telephone number of the recipient or contact person paymentinfo – contains the payment information, including card_last4digits last four digits of the card’s dpan cardbrand currently, either mastercard or visa ordernumber merchant’s unique external reference id supplied in the original request’s methoddata parameter if the user pays with a credit card using the basic-card method, then the details response returned directly to your website from the browser will contain cardholdername, cardnumber, expirymonth, expiryyear, cardsecuritycode, billingaddress example request show then paymentresponse => { var paymentdata = { // payment method string, e g “amex” method paymentresponse methodname, // payment details contains payment information details paymentresponse details /* request details depends on pg token mode network - e g , first data; or gateway - e g , stripe ---------------------------------------------------------|------------------------------------------------------| * gateway token mode |* network token mode | * “details” { |* “details { | * “paymentcredential” { |* “method” “3ds”, | * “reference” “tok_1asceoyf6ypzj7f8se6grp0i”, |* “paymentcredential” { | * “status” “authorized” |* “type” “s”, | * }, |* “version” “100”, | * |* “data” “long_encrypted_payload_value”, | * |* }, | *--------------------------------------------------------|------------------------------------------------------| * “paymentinfo” { * “card_last4digits” “1489”, * “cardbrand” “mastercard”, * “ordernumber” “1233123”, * “billingaddress” { * “country” “usa”, * “addressline” [“chhccy”, “hdyxych”], * “region” “ca”, * “city” “mountain view”, * “dependentlocality” “”, * “postalcode” “94043”, * “sortingcode” “”, * “languagecode” “en”, * “organization” “”, * “recipient” “”, * “phone” “” * } * } * } * */ }; return fetch ‘/validatepayment’, { method ‘post’, headers { ‘content-type’ ‘application/json’ }, body json stringify paymentdata } then res => { if res status === 200 { return res json ; } else { throw ‘payment error’; } } then res => { paymentresponse complete “success” ; }, err => { paymentresponse complete “fail” ; } ; } catch err => { console error “error, something went wrong”, err message ; } ; once payment information is received from samsung pay, the website should submit the payment information to the merchant’s pg for transaction processing the ui will show a spinner while the request takes place when a response is received, the website should call complete to close the ui the website is then free to show an order complete or order confirmation page for user feedback as previously mentioned, you can simplify integration of network tokens by passing the encrypted payload directly to your pg and letting it handle decryption in all cases, how you handle a submitted network token depends on the payment gateway refer to your particular pg’s documentation for details paymentoptions is an optional parameter in thepaymentrequest constructor depending on your particular requirements, you may want additional information, such as the user’s shipping address for physical goods purchased and contact details for guest users paymentoptions currently comprises the following requestpayername true if payer name is required; otherwise, false requestpayeremail true if payer email address is required; otherwise, false requestpayerphone true if payer telephone number is required; otherwise, false requestshipping true if shipping address is required; otherwise, false shippingtype available label options “shipping/pickup/delivery” for indicating to user; solely for display purposes example var options = { requestpayeremail false, requestpayername true, requestpayerphone false, requestshipping true, shippingtype "delivery" } noteif any of the elements listed above are set to true, the browser payment sheet is launched; otherwise, the samsung pay payment sheet is displayed putting it all together let’s assemble the various code blocks into a prototype to demonstrate the w3c payment request api in action function onbuyclicked { const samsung_pay = 'https //spay samsung com'; if !window paymentrequest { // paymentrequest api is not available - forwarding to legacy form based experience location href = '/checkout'; } // setup var supportedinstruments = [{ supportedmethods [ samsung_pay ], // 'https //spay samsung com' data { "version" "1", "productid" "2bc3e6da781e4e458b18bc", //service id from partner portal "allowedcardnetworks" ['mastercard','visa'], "ordernumber" "1233123", "merchantname" "shop samsung demo ", //merchant name in partner portal "merchantgatewayparameter" {"userid" "acct_17irf7f6ypzj7wor"}, "isrecurring" false, "billingaddressrequired" false, "paymentprotocol" "protocol_3ds" } }]; var details = { displayitems [{ label 'original donation amount', amount { currency 'usd', value '65 00' } }, { label 'friends and family discount', amount { currency 'usd', value '-10 00' } }], total { label 'total due', amount { currency 'usd', value '55 00' } }; var options = { requestshipping true, requestpayeremail true, requestpayerphone true, requestpayername true }; // initialization var request = new paymentrequest supportedinstruments, details, options ; // when user selects a shipping address request addeventlistener 'shippingaddresschange', e => { e updatewith details, addr => { var shippingoption = { id '', label '', amount { currency ‘usd’, value ‘0 00’ }, selected true}; // shipping to us is supported if addr country === 'us' { shippingoption id = 'us'; shippingoption label = 'standard shipping in us'; shippingoption amount value = '0 00'; details total amount value = '55 00'; // shipping to jp is supported } else if addr country === 'jp' { shippingoption id = 'jp'; shippingoption label = 'international shipping'; shippingoption amount value = '10 00'; details total amount value = '65 00'; // shipping to elsewhere is unsupported } else { // empty array indicates rejection of the address details shippingoptions = []; return promise resolve details ; { // hardcoded for simplicity if details displayitems length === 2 { details displayitems[2] = shippingoption; } else { details displayitems push shippingoption ; } details shippingoptions = [shippingoption]; return promise resolve details ; } details, request shippingaddress ; } ; // when user selects a shipping option request addeventlistener 'shippingoptionchange', e => { e updatewith details => { // there should be only one option do nothing return promise resolve details ; } details ; } ; // show ui then continue with user payment info request show then result => { // post the result to the server return fetch '/pay', { method 'post', credentials ‘include’, headers { 'content-type' 'application/json' }, body json stringify result tojson } then res => { // only if successful if res status === 200 { return res json ; } else { throw 'failure'; } } then response => { // you should have received a json object if response success == true { return result complete 'success' ; } else { return result complete 'fail' ; } } then => { console log 'thank you!', result shippingaddress tojson , result methodname, result details tojson ; } catch => { return result complete 'fail' ; } ; } catch function err { console error 'uh oh, something bad happened ' + err message ; } ; } document queryselector '#start' addeventlistener 'click', onbuyclicked ; refer to the official w3c integration specs for additional details and definition testing once you have the code saved and loaded, you’re ready to test be sure to test your website or test domain on a device running samsung internet browser and with the samsung pay wallet app already set up and ready to go in accordance with the prerequisites cited above if you use a separate subdomain for your test environment, be sure to add it as an eligible service domain for the service you configured under registering your domain for the w3c service remember that any/all subdomains for production must also be added to the service, up to a maximum of 10 service domains again, please note that samsung pay’s webpay api currently supports mastercard and visa only support for american express and discover is under development and will be available soon be sure to test using the samsung internet and chrome mobile browser apps to test select samsung pay as the payment method by clicking on the branded samsung pay button branded implementations or the samsung pay radio button standard w3c implementations this should launch the samsung pay payment sheet authenticate payment validate your results end to end isolate issues in the log, debug, and test again contact your samsung pay rm to coordinate assistance with troubleshooting recommended test cases check if the samsung pay is available in the payment option on the website verify samsung pay logo on browser sheet verify order summary on the payment sheet verify “edit” and “pay” buttons on payment sheet verify purchased item in the summary verify the billing address on the payment sheet change the billing address try to change the card in payment sheet when only one card is enrolled in samsung pay try to change the card when multiple cards is enrolled in samsung pay verify the payment amount verify the payment options verify the payment completion screen verify merchant name on the payment sheet verify merchant domain name on the payments sheet verify “cancel” and “pay” buttons on browser sheet try to make payment with large amount larger than max allowed amount and verify the behavior make a payment using samsung pay with a card already added for the merchant’s website basic-card verify transaction notification after w3c purchase verify transaction notification after refund set payment options for shipping address and verify that browser payment sheet launches and captures shipping address input/changes by user verify that the shipping cost is updated based on a shipping address change and is reflected in the updated total amount release once your tests are successful and you are satisfied with the results, take the following steps to ready your integrated with samsung pay website for release go to the samsung pay developers portaland create a new release service sharing identical attributes with the service you successfully tested a click on service management, then click create new service b select for release pictured , then click next c select w3c mobile web payments as the service type, then click next d enter a "release" service name and select "united states" as the service country e select united states as the service country f select your payment gateway from the drop-down menu, then click connect with for gateway token mode or provide a valid csr for network token mode g enter your service domain and click add for each additional domain name, click add remember, when entering domain names on the portal, do not include a "https"//" prefix h confirm your agreement with the terms and conditions, then click next retrieve the service id from the service details page and enter copy-paste it into your website's methoddata object in place of the current testing service id when your service is approved by your samsung pay rm — as indicated in the status column of your service management dashboard — you're ready to release your integrated website to the public send queries concerning service package approval to webpayment@samsungpay com

membership > device list" menu, you can select it immediately and add it to the duid list for the alpha test noteduid information means unique id in "tv menu > support > about this tv > smart hub information" what to check if duid registration for alpha test failstvs that do not support alpha testing, or that do not match the architecture of the alpha testing version, cannot be registered as tvs for alpha testing duids on these tvs are automatically excluded even if you attempt to register in addition, only tvs using the smart service apps panel entry, app download, tv plus viewing, etc within the last six months can be registered as duid for alpha testing if duid registration fails, please check 1 whether the tv is connected to the network and 2 if you have used tv smart service recently if you have not used a tv smart service in the last 6 months, try using it on that tv and registering the duid again after at least 8 hours after entering all of the information and clicking the "done" button, you are ready to start the alpha test, and the status of the version is changed to 'alpha testing' in the "applications > distribute > alpha test" list, you can check the submitted application version and alpha test progress it may take a few minutes for the alpha version to be distributed, and you can only access it on the tvs whose duid you have registered to modify alpha test information during the alpha test, you can adjust the test period or add/delete test tv duids you can also start a new test with a version of the application that has already been alpha tested if you click the "edit" button on the "applications > distribute > alpha test" page, a page is opened where you can modify the alpha test settings you can advance the end date of an ongoing alpha test or extend it by up to 30 days an alpha test that has ended can be restarted by setting up a new test duration of up to 30 days from the present moment noteif you want to change the start date of an ongoing alpha test, simply quit the test and start over you can remove a test tv by clicking the "delete" button in the duid list for the alpha test, and you can add a tv by clicking the "add duid" button you can register up to 50 test tvs per alpha test what to check if duid registration for alpha test failstvs that do not support alpha testing, or that do not match the architecture of the alpha testing version, cannot be registered as tvs for alpha testing duids on these tvs are automatically excluded even if you attempt to register in addition, only tvs using the smart service apps panel entry, app download, tv plus viewing, etc within the last six months can be registered as duid for alpha testing if duid registration fails, please check 1 whether the tv is connected to the network and 2 if you have used tv smart service recently if you have not used a tv smart service in the last 6 months, try using it on that tv and registering the duid again after at least 8 hours edit the alpha test information and click the "done" button to apply it immediately to stop alpha test you can immediately end an alpha test in progress if you click the "close alpha test" button on the "applications > distribute > alpha test" page, the test is terminated immediately and the status of the version being tested is changed to 'alpha test closed' you can also end the alpha test prematurely using the "edit" button to change the test end date submitting compatibility version whenever a new smart tv model is released, samsung conducts its own compatibility test so that applications that are supported by the existing model can be supported by the new one as well this process takes place before the new model group is released to the tv seller office, and compatibility issues that need to be fixed before launching the application on the new model are reported to the seller these issues can be viewed in the "applications > compatibility defect" menu, and in order for the application to be eligible to be released on the new model, the seller must submit a version that fixes them samsung goes through this process and releases only applications that contain no serious flaws on the new model to submit an application version that resolves a compatibility issue, click the "submit compatibility version" button on the "applications > distribute" page noteyou cannot submit a new version while the application service is stopped if the service has been suspended, resume it first when the page for submitting a compatibility version is provided, first select the version of the application to submit if the version you want to submit is not listed, click the "upload app" button to upload the application package file first noteyou cannot submit a version submitted for a beta or alpha test as a release version we plan on supporting so that it can be possible later select the smart tv model group to release the application version a list of model groups suitable for the architecture of the app package is provided and you can choose from them you should know the following points when selecting model groups model groups with defects cannot be selected before all compatibility flaws have been fixed for more information, see the resolving compatibility defect guide model groups that have a previously submitted version with a number higher than the version you intend to release cannot be selected you cannot select a model group for which the version you want to release has already been released you cannot submit to a model group lower than the api version of the application package if the application has the samsung checkout payment function applied, it cannot be submitted to a model group that does not support samsung checkout in order to release an application to a model group subject to fcc regulations, caption and tts functions must be supported applications that do not support caption or tts functions cannot be submitted to model groups subject to fcc regulations for more information, see the entering application feature information guide if you click the "next" button after selecting the version and model group, the application information and pre-test for the selected model group will be executed, and if there is a problem that prevents the application from being submitted, you will be notified the application title written in the default language and the application title specified in the configuration file of the application package must be identical for more information, see the entering application title and description guide if the samsung checkout payment function is applied to the application, the related privilege api must be defined in the application package configuration file, and account information must be registered in the dpi system along with a record of testing in-app purchases at least once in a dpi sandbox environment for more information, see the entering billing information guide if the in-app ad feature is applied to the application, the related privilege api must be defined in the application package configuration file for more information, see the in-app ad information guide the "built in app" property cannot be changed once it is set, and a new app id must be created to change it if you have not clearly identified the properties, please consult with the app working group appwg vd@samsung com and then submit the application if the pre-test fails, the application cannot be submitted in such cases, review and fix the issues found before proceeding with the launch request again after the pre-test is passed, click the "done" button to complete the submission in the "applications > distribute > compatibility" list, you can check the submitted version of your application