Event Ticket
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 type wallet card subtype ticket performances, sports, movies, entrances, others performances movies sports entrances wallet card data fields attributes type value description attributes {fields} titlestring 32 required main title e g , mlb ticket category deprecated string 16 optional ticket category eventidstring 32 optional if the event is cancelled, use this identifier to find and process all associated tickets groupingidstring 32 optional identifier used to group related cards orderidstring 32 optional a unique identifier for an order mainimgstring 256 required url for main ticket image the file size should not exceed 512 kb subtitle1string 32 optional auxiliary field that displays supporting information logoimagestring 256 required logo image url to be displayed in the card item the file size should not exceed 256 kb logoimage darkurlstring 256 required logo image url in dark mode this is a flat key name, not a nested object path the file size should not exceed 256 kb logoimage lighturlstring 256 required logo image url in light mode this is a flat key name, not a nested object path the file size should not exceed 256 kb wideimagestring 256 optional wide horizontal image url displayed on the card information screen the file size should not exceed 256 kb providernamestring 32 required ticket provider name classificationstring 16 optional classification of tickets use onetime, regular, or annual * default onetime holdernamestring 64 optional name of the cardholder idphotostring 20k optional holder’s photo image data encoded base64 idphoto formatstring 32 optional image file formate g , jpeg, png * unsupported image formats may exist idphoto statusstring 16 optional status of the dataallowed value unchanged gradestring 32 optional ticket grade seatclassstring 32 optional seat class entrancestring 64 optional entrance gate seatnumberstring 256 optional seat location seatlayoutimagestring 256 optional url of the seat layout image the file size should not exceed 512 kb issuedatelong 13 required issue date epoch timestamp in milliseconds reservationnumberstring 32 required reservation number userstring 64 optional name of person who made the reservation certificationstring 16 optional ticket certification e g ,r, as a film rating reactivatableynstring 1 optional flag whether the card is able to activate an expired ticket temporarily either 'y' or 'n' * default 'n' preventcaptureynstring 1 optional flag whether this wallet card view prevents screen capture either 'y' or 'n'* default 'n' nonetworksupportynstring 1 optional specifies whether the wallet card can be opened while the device is offline either 'y' or 'n' * default 'n' displayredeembuttonynstring 1 optional indicates whether to display the redeem button either 'y' or 'n'* default 'n' startdatelong 13 required start date displayed start date epoch timestamp in milliseconds startdate utcoffsetstring 8 optional utc offset of start date time at the event location enddatelong 13 optional end date displayed end date epoch timestamp in milliseconds * if null, the card will expire in 10 hours from startdate enddate utcoffsetstring 8 optional utc offset of the end date and time at the event location person1string 512 optional number of persons by category * see classification format locationsstring 1024 optional list of locations where the card can be used * see locations format noticedescstring 5000 required text of the notice * long content is allowed * see additional information format extendedfieldsstring 1024 optional a flexible list of key-value pairs* see extended fields groupinfo1 deprecated string 64 optional the first common information with the same groupingid groupinfo2 deprecated string 64 optional the second common information with the same groupingid * it is recommended to set groupinfo1 first groupinfo3 deprecated string 64 optional the third common information with the same 'groupingid' * it is recommended to set groupinfo1, groupinfo2 first csinfostring 4096 optional provider customer service information provide the value as an escaped json string * allowed items call, email, website, facebook, youtube, or instagram * see the example below privacymodeynstring 1 optional whether user authentication is required when using the card either ‘y’ or ‘n’ * default ‘n’ applinklogostring 256 required app link image url the file size should not exceed 256 kb applinknamestring 32 required app link name applinkdatastring 256 required information about the partner app link bgcolorstring 8 optional colour of the card art e g , #00ffff fontcolorstring 8 optional colour of the text on the card art acceptable values dark, light blinkcolorstring 8 optional colour of the blinking effect in the indicator area e g , #00ffff providerviewlinkobject array 4096 optional a list of links that allow a content provider to expose additional information or related actions to the user up to 5 links are supported * see links barcode valuestring 4096 optional actual data that is delivered when the barcode/qr code is scanned barcode visiblefromlong 13 optional the time from which the barcode or qr code is available for display the value must be an epoch timestamp in milliseconds before this time, the barcode and qr code must remain hidden * supported only by the samsung wallet app version released in october 2026 barcode serialtypestring 32 optional presentation type e g , serialnumber, barcode * see barcode & qr code presentation barcode ptformatstring 32 optional presentation format e g , barcode, qrcode, serial * see barcode & qr code presentation barcode ptsubformatstring 32 optional presentation sub-format e g , code_128, qr_code * see barcode & qr code presentation barcode errorcorrectionlevelstring 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 barcode intervalstring 11 conditional refresh interval for dynamic barcode updates, in milliseconds * required when barcode generationtype is interval selectoridstring 8 optional when samsung app-resident nfc is supported, it refers to the identifier issued during wallet card settings when using the card's nfc function, the terminal can transmit selectorid to the user's device upon receiving selectorid, the device can identify the benefit service and perform additional actions accordingly * refer to access integration guide samsung approval required contact technical support provision datastring 512 optional elements to complete provisioning * refer to access integration guide samsung approval required contact technical support provision intervalstring 16 optional update interval for dynamic provisioning, in milliseconds * refer to access integration guide samsung approval required contact technical support relcoupon{i} titlestring 32 conditional coupon title * required if this ticket has a related couponi 1~3 relcoupon{i} subtitlestring 32 optional coupon subtitlei 1~3 relcoupon{i} providernamestring 32 conditional coupon provider name * required if this ticket has a related couponi 1~3 relcoupon{i} imagefilesrcstring 256 optional coupon image url the file size should not exceed 256 kb i 1~3 relcoupon{i} noticedescriptionstring 1024 optional text of the notice * long content is allowed * see additional information i 1~3 relcoupon{i} notificationtimelong 13 optional coupon exposure time epoch timestamp in milliseconds i 1~3 relcoupon{i} valuestring 4096 conditional actual data that is delivered when the barcode/qr code is scanned i 1~3 relcoupon{i} serialtypestring 32 required presentation type e g , serialnumber, barcode, * see barcode & qr code presentation i 1~3 relcoupon{i} ptformatstring 32 conditional presentation format e g , barcode, qrcode, serial, * see barcode & qr code presentation i 1~3 relcoupon{i} ptsubformatstring 32 conditional presentation sub-format e g , code_128, qr_code, * see barcode & qr code presentation i 1~3 relcoupon{i} errorcorrectionlevelstring 4 optional amount of redundant data included for error correction qr codes support four error-correction levels • code options l/m/q/hi 1~3 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", "logoimage lighturl" "https // /logo-light png", "issuedate" 1686657600000, "reservationnumber" "glx-0613-001", "startdate" 1686657600000, "enddate" 1718280000000, "holdername" "kim eunha", "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\" \"0000-0000\",\"email\" \"samsungwallet@samsungwallet com\",\"website\" \"https //www samsungwallet com/cs/\",\"instagram\" \"https //www instagram com/samsungwallet\",\"youtube\" \"https //www youtube com/@samsungwallet\",\"facebook\" \"https //www facebook com/samsungwallet\" }", "applinkname" "galaxy ticket", "applinklogo" "https // /applinklogo png", "applinkdata" "https //www applinkdata com", "bgcolor" "#e86d1f", "fontcolor" "light", "blinkcolor" "#e86d1f", "barcode value" "serial-0613-001", "barcode visiblefrom" 1790841600000, "barcode serialtype" "qrcode", "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" } }] }] } }