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
Figure 1: Sample UI: Reservation - Rentalcars

Accommodations
Figure 2: Sample UI: Reservation - Accommodations

Etickets
Figure 3: Sample UI: Reservation - Etickets

Activities
Figure 4: Sample UI: Reservation - Activities

Others
Figure 5: Sample UI: Reservation - Others

Wallet Card data fields

Attributes

Type

 Value

 Description
attributes.{fields}

 title
String(32)

 (Required)
Main title
subtitle
String(32)

 (Optional)
Auxiliary field that displays supporting information.
groupingId
String(32)

 (Optional)
Identifier used to group related cards.
linkingId
String(32)

 (Optional)
Identifier used to transfer related cards.
linkingOrder
String(4)

 (Optional)
Priority used to order related reservation cards that share the same linkingId.
appLinkLogo
String(256)

 (Required)
App link image URL.
The file size should not exceed 256 kB.
appLinkName
String(32)

 (Required)
App link name.
appLinkData
String(256)

 (Required)
Information about the partner app link.
mainImg
String(256)

 (Required)
URL for main image.
The file size should not exceed 512 kB.
logoImage
String(256)

 (Optional)
Logo image URL to be displayed on the card item
The file size should not exceed 256 kB
logoImage.darkUrl
String(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.lightUrl
String(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
bgColor
String(8)

 (Optional)
Colour of the card art.
e.g., #00FFFF.
fontColor
String(8)

 (Optional)
Colour of the text on the card art.
Acceptable values: dark, light
blinkColor
String(8)

 (Optional)
Colour of the blinking effect in the indicator area.
e.g., #00FFFF
preventCaptureYn
String(1)

 (Optional)
Flag whether this wallet card view prevents screen capture
Either 'Y' or 'N'
* Default: 'N'
noNetworkSupportYn
String(1)

 (Optional)
Specifies whether the Wallet Card can be opened while the device is offline.
Either 'Y' or 'N'
* Default: 'N'
providerName
String(32)

 (Conditional)
Provider name.
* Required if subType is accommodations or rentalcars.
* For etickets, provide the provider name in itineraryInformation.
locations
String(1024)

 (Optional)
List of locations where the card can be used.
* See Locations format.
csInfo
String(4096)

 (Optional)
Customer service information.
Provide the value as an escaped JSON object containing calls, emails, or websites.
* See the example below.
summaryUrl
String(256)

 (Optional)
Web page URL that shows details, such as balance
parentRefId
String(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.
startDate
Long(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.zoneId
String(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.literalValue
String(32)

 (Optional)
Formatted start time to display on the screen.
format : YYYY-MM-DDThh:mm:ss
ex) 2025-10-30T14:35:00
startDate.latitude
Double

 (Optional)
Latitude of the start location.
* Input when timestamp and zoneId information is not known
startDate.longitude
Double

 (Optional)
Longitude of the start location.
* Input when timestamp and zoneId information is not known
startDate.address
String(256)

 (Optional)
Address of the start location.
* Input when timestamp and zoneId information is not known
endDate
Long(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.zoneId
String(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.literalValue
String(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.latitude
Double

 (Optional)
Latitude of the end location.
* Input when timestamp and zoneId information is not known
endDate.longitude
Double

 (Optional)
Longitude of the end location.
* Input when timestamp and zoneId information is not known
endDate.address
String(256)

 (Optional)
Address of the end location.
* Input when timestamp and zoneId information is not known
noticeDesc
String(5000)

 (Optional)
Notice description
* Long content is allowed.
* See Additional information format
agentName
String(64)

 (Optional)
Name of the person in charge of managing the reservation
agentContactNumber
String(32)

 (Optional)
Contact information of the person in charge of managing the reservation
reservationNumber
String(32)

 (Required)
Reservation number.
reservationAmount
String(32)

 (Optional)
Reservation amount.
paymentType
String(32)

 (Optional)
Payment type for guarantee or full payment
paymentInformation
String(64)

 (Optional)
Payment Information
ex)card brand, card number
extraInfo
String(5000)

 (Optional)
Additional information to be delivered to customers.
* Long content is allowed.
* See Additional information format
fullName
String(64)

 (Required)
Name of person who made the reservation.
firstName
String(64)

 (Required)
First name of the person who made the reservation.
lastName
String(64)

 (Required)
Last name of the person who made the reservation.
phoneNumber
String(16)

 (Required)
Phone number of the person who made the reservation.
email
String(32)

 (Optional)
Email address of the person who made the reservation.
organization
String(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.
itineraryInformationList
Array 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.
itinerary
String(1024)

 (Conditional)
Detailed itinerary for the trip.
passengerNameRecord
String(8)

 (Conditional)
Digital record of a passenger’s travel information that’s created when a reservation is made. (PNR)
* Required if subtype is etickets
issuranceStatus
String(512)

 (Optional)
Current state of a ticket, which can provide an overview of what is happening with it.
* See Issuance Status
carSize
String(16)

 (Optional)
Car size.
* Required if subType is rentalcars.
carModel
String(64)

 (Optional)
Car model.
* Required if subType is rentalcars.
pickup
String(256)

 (Optional)
Place to pick up a rental car.
dropOff
String(256)

 (Optional)
Place where the vehicle should be returned
inclusion
String(256)

 (Optional)
Details included in the reservation
roomType
String(256)

 (Optional)
Room type.
* Required if subType is accommodations.
partySize
String(4)

 (Optional)
Number of people included in the reservation.
* Required if subType is restaurants.
orderMenu
String(128)

 (Optional)
Menu ordered by the user.
* Required if subType is restaurants.
luggageCount
String(4)

 (Optional)
The total number of pieces of luggage being transported.
airport
String(64)

 (Optional)
Name of the arrival airport.
vehicleNumber
String(32)

 (Optional)
Transit or route number
arrival.time
Long(13)

 (Optional)
Arrival time
Epoch timestamp in milliseconds.
arrival.zoneId
String(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.literalValue
String(32)

 (Optional)
Formatted arrival time to display on the screen.
format : YYYY-MM-DDThh:mm:ss
ex) 2025-10-30T14:35:00
arrival.latitude
Double

 (Optional)
Latitude of the arrival location.
* Input when timestamp and zoneId information is not known
arrival.longitude
Double

 (Optional)
Longitude of the arrival location.
* Input when timestamp and zoneId information is not known
arrival.address
String(256)

 (Optional)
Address of the arrival location.
* Input when timestamp and zoneId information is not known
vehicleType
String(32)

 (Optional)
The type of ride or vehicle service being requested
driverName
String(64)

 (Optional)
The name of the driver
driverContactNumber
String(32)

 (Optional)
Contact information of the driver
barcode.value
String(4096)

 (Optional)
Actual data that is delivered when the barcode/QR code is scanned.
barcode.serialType
String(32)

 (Optional)
Presentation Type
e.g., SERIALNUMBER, BARCODE, ...
* See Barcode & QR Code Presentation
barcode.ptFormat
String(32)

 (Optional)
Presentation Format
e.g., BARCODE, QRCODE, SERIAL, ...
* See Barcode & QR Code Presentation
barcode.ptSubFormat
String(32)

 (Optional)
Presentation Sub-format
e.g., CODE_128, QR_CODE, ...
* See Barcode & QR Code Presentation
barcode.errorCorrectionLevel
String(4)

 (Optional)
Amount of redundant data included for error correction.
QR codes support four error-correction levels.
• Code options: L/M/Q/H
barcode.interval
String(11)

 (Conditional)
Refresh interval for dynamic barcode updates, in milliseconds.
* Required when barcode.generationType is INTERVAL.
privacyModeYn
String(1)

 (Optional)
Whether user authentication is required when using the card
Either ‘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"
        }
      }
    ]
  }
}