Reservation
reservation 'reservation' cards support user-booked content such as e-tickets, accommodation, rental cars, and restaurants wallet card type wallet card subtype reservation rentalcars, restaurants, accommodations, etickets, taxis, 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 that 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 used to order related reservation cards that share the 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 on the card item the file size should not exceed 256 kb logoimage darkurlstring 256 optional 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* if this value does not exist, logoimage will be substituted logoimage lighturlstring 256 optional 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* if this value does not exist, logoimage will be substituted 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 preventcaptureynstring 1 optional flag whether this wallet card view prevents screen captureeither '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' providernamestring 32 conditional provider name * required if subtype is accommodations or rentalcars * for etickets, provide the provider name in itineraryinformation locationsstring 1024 optional list of locations where the card can be used * see locations format csinfostring 4096 optional customer service information provide the value as an escaped json object containing calls, emails, or websites * see the example below summaryurlstring 256 optional web page url that shows details, such as balance parentrefidstring 32 optional a unique content identifier for the parent card, defined by the content provider 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 deprecated string 8 optional utc offset of time at the start point startdate zoneidstring 64 optional unique identifier for a time zone as defined by the iana time zone database it represents a specific region's time zone, including rules for daylight saving time dst and historical changes ex "america/new_york", "europe/london" startdate literalvaluestring 32 optional formatted start time to display on the screen format yyyy-mm-ddthh mm ssex 2025-10-30t14 35 00 startdate latitudedouble optional latitude of the start location * input when timestamp and zoneid information is not known startdate longitudedouble optional longitude of the start location * input when timestamp and zoneid information is not known startdate addressstring 256 optional address of the start location * input when timestamp and zoneid information is not known enddatelong 13 optional end date display end date epoch timestamp in milliseconds enddate utcoffset deprecated string 8 optional utc offset of time at the end point enddate zoneidstring 64 optional unique identifier for a time zone 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 valueformat yyyy-mm-ddthh mm ssex 2025-10-30t14 35 00 enddate latitudedouble optional latitude of the end location * input when timestamp and zoneid information is not known enddate longitudedouble optional longitude of the end location * input when timestamp and zoneid information is not known enddate addressstring 256 optional address of the end location * 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 informationex 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 first name of the person who made the reservation lastnamestring 64 required last name of the person who made the reservation phonenumberstring 16 required phone number of the person who made the reservation emailstring 32 optional email address of the person who made the reservation organizationstring 64 optional organisation to which the cardholder belongs for example, a department, division, affiliation, association or team membership[]string 64 optional unique id value such as a membership number for etickets, multiple membership values are supported when the associated airlines differ itineraryinformationlistarray of object conditional itinerary information* required if subtype is etickets * see itinerary information format itineraryinformation deprecated string 5000 conditional itinerary information* required if subtype is etickets * see [itinerary information]itinerary information] format itinerarystring 1024 conditional detailed itinerary 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 is happening with it * see issuance status carsizestring 16 optional car size * required if subtype is rentalcars carmodelstring 64 optional car model * required if subtype is rentalcars 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 room type * required if subtype is accommodations partysizestring 4 optional number of people included in the reservation * required if subtype is restaurants ordermenustring 128 optional menu ordered by the user * required if subtype is restaurants luggagecountstring 4 optional the total number of pieces of luggage being transported airportstring 64 optional name of the arrival airport vehiclenumberstring 32 optional transit or route number arrival timelong 13 optional arrival timeepoch timestamp in milliseconds arrival zoneidstring 64 optional unique identifier for a time zone 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 formatted arrival time to display on the screen format yyyy-mm-ddthh mm ssex 2025-10-30t14 35 00 arrival latitudedouble optional latitude of the arrival location * input when timestamp and zoneid information is not known arrival longitudedouble optional longitude of the arrival location * input when timestamp and zoneid information is not known arrival addressstring 256 optional address of the arrival location * 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 typee g , serialnumber, barcode, * see barcode & qr code presentation barcode ptformatstring 32 optional presentation formate g , barcode, qrcode, serial, * see barcode & qr code presentation barcode ptsubformatstring 32 optional presentation sub-formate g , code_128, qr_code, * see barcode & qr code presentation barcode errorcorrectionlevelstring 4 optional amount of redundant data included for error correction qr codes support four error-correction levels • code options l/m/q/h barcode intervalstring 11 conditional refresh interval for dynamic barcode updates, in milliseconds * required when barcode generationtype is interval privacymodeynstring 1 optional whether user authentication is required when using the cardeither ‘y’ or ‘n’* default ‘n’ example [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" "dark", "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", "fullname" "samsung kim", "phonenumber" "+821012345678", "membership" "[\"membership1\",\"membership2\"]", "organization" "samsung electronics", "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" "san francisco", "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" "san francisco", "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 -san francisco, ca sfo san francisco, ca sfo -seoul icn ", "passengernamerecord" "6ddrze", "issurancestatus" "[{\"ticketnumber\" \"a-9303123959\",\"downloadlink\" \"http //~~~\"},{\"ticketnumber\" \"b-9303123959\",\"downloadlink\" \"http //~~~\"}]" } } ] } } [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" "dark", "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", "fullname" "samsung kim", "phonenumber" "+821012345678", "membership" "[\"membership1\"]", "carsize" "mid-size", "carmodel" "bmw5", "pickup" "san francisco intl airport", "dropoff" "san francisco intl airport" } } ] } } } [sub-type is accommodations] { "card" { "type" "reservation", "subtype" "accommodations", "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" "dark", "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", "fullname" "samsung kim", "phonenumber" "+821012345678", "membership" "[\"membership1\"]", "roomtype" "samsung corporate 1king bed" } } ] } } } [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" "dark", "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", "fullname" "samsung kim", "phonenumber" "+821012345678", "partysize" "3", "luggagecount" "4", "pickup" "san francisco intl airport", "dropoff" "san francisco samsung hotel", "vehiclenumber" "se123", "arrival time" 1743641200000, "drivername" "lee", "drivercontactnumber" "+821012341234", "vehicletype" "taxi-black", "carmodel" "bmw 5" } } ] } } [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" "dark", "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", "fullname" "samsung kim", "phonenumber" "+821012345678", "partysize" "3", "barcode value" "serial-0613-001", "barcode serialtype" "qrcode", "barcode ptformat" "qrcodeserial", "barcode ptsubformat" "qr_code", "privacymodeyn" "y" } } ] } }