Data Structure and Format
wallet can show a map, place name, and address additionally, location information can be used to provide location-based services lbs location information can be represented by a json array and up to 10 locations can be specified note map services are only available in certain countries json format vlaue description [] latdouble optional latitude [] lngdouble optional longitude [] addressstring required string containing the full address [] namestring required branch name example * location information for the entrance to oracle park [ { "lat" 37 779337, "lng" -122 388755, "address" "24 willie mays plaza, san francisco, ca 94107", "name" "willie mays plaza" }, { "lat" 37 77814, "lng" -122 390836, "address" "king st, san francisco, ca 94107", "name" "king st" } ] itinerary information json format vlaue description itineraryinformation[] idstring 32 optional unique id assigned to each segment of the journey itineraryinformation[] orderstring 4 optional order of each segment within the overall itinerary itineraryinformation[] providernamestring 32 conditional provider name * required if subtype is etickets itineraryinformation[] providerlogostring 256 conditional url of the logo image * required if subtype is etickets itineraryinformation[] providerlogo darkurlstring 256 conditional url of the logo image in dark mode * required if subtype is etickets itineraryinformation[] providerlogo lighturlstring 256 conditional url of the logo image in light mode * required if subtype is etickets itineraryinformation[] departureobject conditional information about the place of departure itineraryinformation[] departure namestring 32 conditional name of the departure point * required if subtype is etickets itineraryinformation[] departure codestring 32 conditional iata code for the departure point * required if subtype is etickets itineraryinformation[] departure airportstring 100 conditional airport name of the departure point * required if subtype is etickets itineraryinformation[] departure terminalstring 100 conditional terminal name of the departure point * required if subtype is etickets itineraryinformation[] departure platformstring 100 optional platform name of the departure point itineraryinformation[] departure time xtimestamplong 13 conditional departure time epoch timestamp in milliseconds i e , the estimated time the aircraft plans to pull from the gate, or the actual time the aircraft already pulled from the gate * required if subtype is etickets itineraryinformation[] departure utcoffsetstring 8 conditional utc offset of time at the departure point * required if subtype is etickets itineraryinformation[] departure 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" itineraryinformation[] departure literalvaluestring 32 optional the departure time that should be indicated on the screen is formatted valueformat yyyy-mm-ddthh mm ssex 2025-10-30t14 35 00 itineraryinformation[] departure latitudedouble optional the latitude of where the event is start* input when timestamp and zoneid information is not known itineraryinformation[] departure longitudedouble optional the longitude of where the event is start* input when timestamp and zoneid information is not known itineraryinformation[] departure addressstring 256 optional the address of where the event is start* input when timestamp and zoneid information is not known itineraryinformation[] arrivalobject conditional information about the place of arrival itineraryinformation[] arrival namestring 32 conditional name of the arrival point * required if subtype is etickets itineraryinformation[] arrival codestring 32 conditional iata code for the arrival point * required if subtype is etickets itineraryinformation[] arrival airportstring 100 conditional airport name of the arrival point * required if subtype is etickets itineraryinformation[] arrival terminalstring 100 conditional terminal name of the arrival point * required if subtype is etickets itineraryinformation[] arrival platformstring 100 optional platform name of the arrival point itineraryinformation[] arrival timelong 13 conditional arrival time epoch timestamp in milliseconds i e , the estimated time the aircraft plans to pull from the gate, or the actual time the aircraft already pulled from the gate * required if subtype is etickets itineraryinformation[] arrival utcoffsetstring 8 conditional utc offset of time at the arrival point * required if subtype is etickets itineraryinformation[] 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" itineraryinformation[] arrival literalvaluestring 32 optional the departure time that should be indicated on the screen is formatted value format yyyy-mm-ddthh mm ssex 2025-10-30t14 35 00 itineraryinformation[] arrival latitudedouble optional the latitude of where the event is start* input when timestamp and zoneid information is not known itineraryinformation[] arrival longitudedouble optional the longitude of where the event is start * input when timestamp and zoneid information is not known itineraryinformation[] arrival addressstring 256 optional the address of where the event is start * input when timestamp and zoneid information is not known itineraryinformation[] boardingtimelong 13 optional boarding time epoch timestamp in milliseconds itineraryinformation[] vehiclenumberstring 32 conditional transit or route numberi e , flight number on airlines * required if subtype is etickets itineraryinformation[] coachnumberstring 16 optional identifier assigned to each individual carriage e g , b4 itineraryinformation[] seatclassstring 32 conditional seat class * required if subtype is etickets itineraryinformation[] seatnumberstring 16 optional individual number of the passenger seat e g , a-9, free itineraryinformation[] seatfacingstring 16 optional direction in which the seat is oriented within a carriage it indicates whether the seat is positioned to face the direction of travel or face the opposite direction e g , forward, backward itineraryinformation[] baggageallowancestring 20 optional baggage allowance itineraryinformation[] flighttimestring 8 optional the time required for a flight itineraryinformation[] checkinlinkstring 256 optional link to check in itineraryinformation[] usertypestring 32 optional passenger typei e , classification of passengers like child, adult example { "itineraryinformation" [ { "id" "itineraryid", "order" 1, "departure" { "name" "departurename", "code" "departurecode", "platform" "departureplatform", "time" 1749624040000, "utcoffset" "utc+09 00" }, "arrival" { "name" "arrivalname", "code" "arrivalcode", "platform" "arrivalplatform", "time" 1749624040000, "utcoffset" "utc+09 00" }, "vehiclenumber" "vehiclenumber", "coachnumber" "coachnumber", "seatclass" "seatclass", "seatnumber" "seatnumber", "seatfacing" "seatfacing", "usertype" "usertype" } ] } issurance status json format vlaue description issurancestatus[] ticketnumberstring 256 optional ticket number issurancestatus[] downloadlinkstring 32 optional link to check the ticket itineraryinformation[] usertypestring 32 required passenger type i e , classification of passengers like child, adult example { "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 //~~~\"}]" } } ] } } card art guide loyalty description type bgimage + bgcolor bgimage only description display the bgimage and the bgcolor in a predefined ratio display bgimage fully description