Reservation
reservation 'reservation' cards support user-booked content such as e-tickets, rental cars, and accommodation wallet card type wallet card type wallet card subtype reservation rentalcars, accommodations, etickets, activities, others rentalcars accommodations etickets activities others wallet card data fields attributes type value description attributes {fields} titlestring 32 required main title subtitlestring 32 optional auxiliary field displays supporting information groupingidstring 32 optional identifier used to group related cards linkingidstring 32 optional identifier used to transfer related cards linkingorderstring 4 optional priority that orders among boarding passes which have a same linkingid 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 mainimgstring 256 required url for main image the file size should not exceed 512 kb logoimagestring 256 optional logo image url to be displayed in card itemthe file size should not exceed 256 kb logoimage darkurlstring 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 logoimage lighturlstring 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 bgcolorstring 8 optional color of the card art e g , #00ffff fontcolorstring 8 optional color of the font on the card art acceptable values dark, light blinkcolorstring 8 optional color of the blinking effect in the indicator area e g , #00ffff preventcaptureynstring 1 optional flag whether this wallet card view prevents screen capture either 'y' or 'n'* default 'n' nonetworksupportynstring 1 optional sets whether to support opening the wallet card under 'no network' status either 'y' or 'n'* default 'n' providernamestring 32 conditional provider name * required if subtype is accomodations, rentalcars * eticket's providername is in itineraryinformation locationsstring 1024 optional list of locations where the card can be used * see locations format csinfostring 4096 optional cs informationset value to json object calls or emails or websites * see below for an example summaryurlstring 256 optional webpage url that show details, such as balance parentrefidstring 32 optional a unique content identifier defined by the content provider of the parent card ex if there is a parent relationship with the clip card, it is the clipcard's refid startdatelong 13 optional start date display start date epoch timestamp in milliseconds startdate utcoffset string 8 optional utc offset of time at the start point * this will be deprecated startdate zoneidstring 64 optional unique identifier for a timezone as defined by the iana time zone database it represents a specific region's timezone, including rules for daylight saving time dst and historical changes ex "america/new_york", "europe/london" startdate literalvaluestring 32 optional the departure time that should be indicated on the screen is a formatted value format yyyy-mm-ddthh mm ss ex 2025-10-30t14 35 00 startdate latitudedouble optional the latitude of where the event is start * input when timestamp and zoneid information is not known startdate longitudedouble optional the longitude of where the event is start * input when timestamp and zoneid information is not known startdate addressstring 256 optional the address of where the event is start * input when timestamp and zoneid information is not known enddatelong 13 optional end date display end date epoch timestamp in milliseconds enddate utcoffset string 8 optional utc offset of time at the end point * this will be deprecated enddate zoneidstring 64 optional unique identifier for a timezone as defined by the iana time zone database it represents a specific region’s timezone, including rules for daylight saving time dst and historical changes ex “america/new_york”, “europe/london” enddate literalvaluestring 32 optional the end time that should be indicated on the screen is formatted value format yyyy-mm-ddthh mm ss ex 2025-10-30t14 35 00 enddate latitudedouble optional the latitude of where the event is end * input when timestamp and zoneid information is not known enddate longitudedouble optional the longitude of where the event is end * input when timestamp and zoneid information is not known enddate addressstring 256 optional the address of where the event is end * input when timestamp and zoneid information is not known noticedescstring 5000 optional notice description * long content is allowed * see additional information format agentnamestring 64 optional name of the person in charge of managing the reservation agentcontactnumberstring 32 optional contact information of the person in charge of managing the reservation reservationnumberstring 32 required reservation number reservationamountstring 32 optional reservation amount paymenttypestring 32 optional payment type for guarantee or full payment paymentinformationstring 64 optional payment information ex card brand, card number extrainfostring 5000 optional additional information to be delivered to customers * long content is allowed * see additional information format fullnamestring 64 required name of person who made the reservation firstnamestring 64 required firstname of person who made the reservation lastnamestring 64 required lastname of person who made the reservation phonenumberstring 16 required phone number of person who made the reservation emailstring 32 optional phone number of person who made the reservation organizationstring 64 optional organization of card holders belonging i e , name of department, division, affiliation, association, or team membership[]string 64 optional unique id value such as a membership number in the etickets case, if the associated airlines are different, multiple memberships can exist itineraryinformationlistobject conditional * required if subtype is etickets * see itinerary information format itineraryinformationstring 5000 conditional itinerary information * required if subtype is etickets * see itinerary information format * this will be deprecated itinerarystring 1024 conditional detailed routes for the trip passengernamerecordstring 8 conditional digital record of a passenger’s travel information that’s created when a reservation is made pnr * required if subtype is etickets issurancestatusstring 512 optional current state of a ticket, which can provide an overview of what’s happening with it * see issurance status carsizestring 16 optional car size * required if subtype is rentalcar carmodelstring 64 optional car model * required if subtype is rentalcar pickupstring 256 optional place to pick up a rental car dropoffstring 256 optional place where the vehicle should be returned inclusionstring 256 optional details included in the reservation roomtypestring 256 optional type of room * required if subtype is accommodation partysizestring 4 optional number of people who made a reservation * required if subtype is restaurant ordermenustring 128 optional ordered menu by the user * required if subtype is restaurant luggagecountstring 4 optional the total number of pieces of luggage being transported airportstring 64 optional name of the arrival airport name vehiclenumberstring 32 optional transit or route number arrival timelong 13 optional arrival time epoch timestamp in milliseconds arrival zoneidstring 64 optional unique identifier for a timezone as defined by the iana time zone database it represents a specific region’s timezone, including rules for daylight saving time dst and historical changes ex “america/new_york”, “europe/london” arrival literalvaluestring 32 optional the arrival time that should be indicated on the screen is formatted value format yyyy-mm-ddthh mm ssex 2025-10-30t14 35 00 arrival latitudedouble optional the latitude of arrival area * input when timestamp and zoneid information is not known arrival longitudedouble optional the longitude of arrival area * input when timestamp and zoneid information is not known arrival addressstring 256 optional the address of arrival area * input when timestamp and zoneid information is not known vehicletypestring 32 optional the type of ride or vehicle service being requested drivernamestring 64 optional the name of the driver drivercontactnumberstring 32 optional contact information of the driver barcode valuestring 4096 optional actual data that is delivered when the barcode/qr code is scanned 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 * 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 4 optional update interval if support for dynamic updates epoch timestamp in milliseconds privacymodeynstring 1 optional whether or not to require user authentication when using the card either ‘y’ or ‘n’* default ‘n’ example the sub-type is etickets { "card" { "type" "reservation", "subtype" "etickets", "data" [ { "refid" " etickets -001", "createdat" 1658385817000, "updatedat " 1658385817000, "language" "en", "attributes" { "title" "samsung air", "groupingid" "group-001", "applinklogo" "https // /applinklogo png", "applinkname" "samsung air ", "applinkdata" "https //www oohotel com", "mainimg" "https // /logo png", "logoimage" "https // /main png", "logoimage darkurl" "https // /logo png", "logoimage lighturl" "https // /logo png", "bgcolor" "#00ffff", "fontcolor" "#00ffff", "blinkcolor" "#00ffff", "providername" "oo airline", "csinfo" "{\"call\" \"555} 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "startdate" 1735041600000, "startdate zoneid" "asia/seoul", "enddate" 1735675200000, "enddate zoneid" "asia/seoul", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice 2\",\"content\" [\"description 1\",\"description 2\"]},{\"title\" \"notice 2\",\"content\" [\"description 1\"]}]}", "agentname" "lee", "agentcontactnumber" "03111112222", "reservationnumber" "r123", "firstname" "samsung", "lastname" "kim", "membership" "[\"membership1\",\"membership2\"]", "organization" "samsung eletronics", "itineraryinformationlist" [ { "providername" "samsungairline", "providerlogo" "https // logo png", "providerlogo darkurl" "https // logo png", "providerlogo lighturl" "https // logo png", "departure" { "name" "seoul", "code" "icn", "airport" "incheonintlairport", "terminal" "terminal2", "time" "1735041600000", "utcoffset" "utc+9" }, "arrival" { "name" "sanfrancisco", "code" "sfo", "airport" "sanfranciscointlairport", "terminal" "terminal1", "time" "1735081200000", "utcoffset" "utc+9" }, "boardingtime" "1735038000000", "vehiclenumber" "se123", "seatclass" "economyplus", "baggageallowance" "15kg", "flighttime" "10h25m", "checkinlink" "http //~~" }, { "providername" "samsungairline", "providerlogo" "https // logo png", "providerlogo darkurl" "https // logo png", "providerlogo lighturl" "https // logo png", "departure" { "name" "sanfrancisco", "code" "sfo", "airport" "sanfranciscointlairport", "terminal" "terminal1", "time" "1735635600000", "utcoffset" "utc+9" }, "arrival" { "name" "seoul", "code" "icn", "airport" "incheonintlairport", "terminal" "terminal2", "time" "1735675200000", "utcoffset" "utc+9" }, "boardingtime" "1735632000000", "vehiclenumber" "se123", "seatclass" "economyplus", "baggageallowance" "15kg", "flighttime" "10h25m", "checkinlink" "http //~~" } ], "itinerary" "seoul icn -sanfrancisco, ca sfo sanfrancisco, ca sfo -seoul icn ", "passengernamerecord" "6ddrze", "issurancestatus" "[{\"ticketnumber\" \"a-9303123959\",\"downloadlink\" \"http //~~~\"},{\"ticketnumber\" \"b-9303123959\",\"downloadlink\" \"http //~~~\"}]" } } ] } } the sub-type is rentalcars { "card" { "type" "reservation", "subtype" "rentalcars", "data" [ { "refid" "rental-001", "createdat" 1658385817000, "updatedat " 1658385817000, "language" "en", "attributes" { "title" "rental car reservation", "groupingid" "group-001", "applinklogo" "https // /applinklogo png", "applinkname" "samsung rental", "applinkdata" "https //www oohotel com", "mainimg" "https // /logo png", "logoimage" "https // /main png", "logoimage darkurl" "https // /logo png", "logoimage lighturl" "https // /logo png", "bgcolor" "#00ffff", "fontcolor" "#00ffff", "blinkcolor" "#00ffff", "providername" "samsung rental cars", "csinfo" "{\"call\" \"555} 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "startdate" 1735041600000, "startdate utcoffset" "utc+9", "startdate zoneid" "asia/seoul", "enddate" 1735675200000, "enddate utcoffset" "utc+9", "enddate zoneid" "asia/seoul", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice 2\",\"content\" [\"description 1\",\"description 2\"]},{\"title\" \"notice 2\",\"content\" [\"description 1\"]}]}", "agentname" "lee", "agentcontactnumber" "03111112222", "reservationnumber" "r123", "firstname" "samsung", "lastname" "kim", "membership" "[\"membership1\"]", "carsize" "mid-size", "carmodel" "bmw5", " ubtyp" "san francisco intl airport", "droppff" "san francisco intl airport" } } ] } } the sub-type is accomodations { "card" { "type" "reservation", "subtype" "accomodations", "data" [ { "refid" "hotel-001", "createdat" 1658385817000, "updatedat " 1658385817000, "language" "en", "attributes" { "title" "hotel seoul", "groupingid" "group-001", "applinklogo" "https // /applinklogo png", "applinkname" "oo restaurant", "applinkdata" "https //www oohotel com", "mainimg" "https // /logo png", "logoimage" "https // /main png", "logoimage darkurl" "https // /logo png", "logoimage lighturl" "https // /logo png", "bgcolor" "#00ffff", "fontcolor" "#00ffff", "blinkcolor" "#00ffff", "providername" "samsung hotel seoul", "csinfo" "{\"call\" \"555} 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "startdate" 1735041600000, "startdate utcoffset" "utc+9", "startdate zoneid" "asia/seoul", "enddate" 1735675200000, "enddate utcoffset" "utc+9", "enddate zoneid" "asia/seoul", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice 2\",\"content\" [\"description 1\",\"description 2\"]},{\"title\" \"notice 2\",\"content\" [\"description 1\"]}]}", "agentname" "lee", "agentcontactnumber" "03111112222", "reservationnumber" "r123", "firstname" "samsung", "lastname" "kim", "membership" "[\"membership1\"]", "roomtype" "samsung corporat 1king bed" } } ] } } the sub-type is taxis { "card" { "type" "reservation", "subtype" "taxis", "data" [ { "refid" "taxi-001", "createdat" 1658385817000, "updatedat " 1658385817000, "language" "en", "attributes" { "title" "taxi seoul", "applinklogo" "https // /applinklogo png", "applinkname" "oo taxi", "applinkdata" "https //www --taxi com", "mainimg" "https // /logo png", "logoimage" "https // /main png", "logoimage darkurl" "https // /logo png", "logoimage lighturl" "https // /logo png", "bgcolor" "#00ffff", "fontcolor" "#00ffff", "blinkcolor" "#00ffff", "providername" "samsung taxi seoul", "csinfo" "{\"call\" \"555} 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "startdate" 1735041600000, "startdate zoneid" "asia/seoul", "enddate" 1735675200000, "enddate zoneid" "asia/seoul", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice 2\",\"content\" [\"description 1\",\"description 2\"]},{\"title\" \"notice 2\",\"content\" [\"description 1\"]}]}", "reservationnumber" "taxi-250101-01", "firstname" "samsung", "lastname" "kim", "partysize" "3", "luggagecount" "4", " ubtyp" "san francisco intl airport", "dropoff" "san francisco samsung hotel", "vehiclenumber" "se123", "arrival time" 1743641200000, "arrival utcoffset" "utc+9", "drivername" "lee ubtype", "drivercontactnumber" "+821012341234", "vehicletype" "taxi-black", "carmodel" "bmw 5", "platenumber" "1abc1000" } } ] } } the sub-type is activities { "card" { "type" "reservation", "subtype" "activities", "data" [ { "refid" "activities-001", "createdat" 1658385817000, "updatedat " 1658385817000, "language" "en", "attributes" { "title" "leisure sports seoul", "applinklogo" "https // /applinklogo png", "applinkname" "oo leisure sports", "applinkdata" "https //www --taxi com", "mainimg" "https // /logo png", "logoimage" "https // /main png", "logoimage darkurl" "https // /logo png", "logoimage lighturl" "https // /logo png", "bgcolor" "#00ffff", "fontcolor" "#00ffff", "blinkcolor" "#00ffff", "providername" "leisure sports seoul", "csinfo" "{\"call\" \"555} 123-4567\", \"email\" \"cs@email com\", \"website\" \"https //homepage com/cs\"}", "startdate" 1735041600000, "startdate zoneid" "asia/seoul", "enddate" 1735675200000, "enddate zoneid" "asia/seoul", "noticedesc" "{\"count\" 2,\"info\" [{\"title\" \"notice 2\",\"content\" [\"description 1\",\"description 2\"]},{\"title\" \"notice 2\",\"content\" [\"description 1\"]}]}", "reservationnumber" "taxi-250101-01", "firstname" "samsung", "lastname" "kim", "partysize" "3", "barcode value" "serial-0613-001", "barcode serialtype" "qrcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code", "privacymodeyn" "y" } } ] } }