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}

 title
String(32)

 (Required)
Main title.
subtitle
String(32)

 (Optional)
Auxiliary field 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 that orders among boarding passes which have a 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 in card item
The file size should not exceed 256 kB
logoImage.darkUrl
String(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.lightUrl
String(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.
bgColor
String(8)

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

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

 (Optional)
Color 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)
Sets whether to support opening the wallet card under 'No Network' Status.
Either 'Y' or 'N'
* Default: 'N'
providerName
String(32)

 (Conditional)
Provider name.
* Required if subType is accomodations, rentalcars.
* eticket's providerName is in itineraryInformation.
locations
String(1024)

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

 (Optional)
CS Information
Set value to JSON Object(calls or emails or websites)
* See below for an example
summaryUrl
String(256)

 (Optional)
Webpage url that show details, such as balance.
parentRefId
String(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.
startDate
Long(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.zoneId
String(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.literalValue
String(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.latitude
Double

 (Optional)
The latitude of where the event is start.
* Input when timestamp and zoneId information is not known.
startDate.longitude
Double

 (Optional)
The longitude of where the event is start.
* Input when timestamp and zoneId information is not known.
startDate.address
String(256)

 (Optional)
The address of where the event is start.
* Input when timestamp and zoneId information is not known.
endDate
Long(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.zoneId
String(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.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)
The latitude of where the event is end.
* Input when timestamp and zoneId information is not known.
endDate.longitude
Double

 (Optional)
The longitude of where the event is end.
* Input when timestamp and zoneId information is not known.
endDate.address
String(256)

 (Optional)
The address of where the event is end.
* 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)
Firstname of person who made the reservation.
lastName
String(64)

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

 (Required)
Phone Number of person who made the reservation.
Email
String(32)

 (Optional)
Phone Number of person who made the reservation.
Organization
String(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.
itineraryInformationList
Object

 (Conditional)
* Required if subtype is etickets.
* See Itinerary information format.
itineraryInformation
String(5000)

 (Conditional)
Itinerary information.
* Required if subtype is etickets.
* See Itinerary Information format.
* This will be deprecated.
Itinerary
String(1024)

 (Conditional)
Detailed routes 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’s happening with it.
* See Issurance Status.
carSize
String(16)

 (Optional)
Car size.
* Required if subtype is rentalCar.
carModel
String(64)

 (Optional)
Car Model.
* Required if subtype is rentalCar.
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)
Type of room.
* Required if subtype is accommodation.
partySize
String(4)

 (Optional)
Number of people who made a reservation.
* Required if subtype is restaurant.
orderMenu
String(128)

 (Optional)
Ordered menu by the user.
* Required if subtype is restaurant.
luggageCount
String(4)

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

 (Optional)
Name of the arrival airport name.
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 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.literalValue
String(32)

 (Optional)
The arrival time that should be indicated on the screen is formatted value.
format : YYYY-MM-DDThh:mm:ss
ex) 2025-10-30T14:35:00
arrival.latitude
Double

 (Optional)
The latitude of arrival area.
* Input when timestamp and zoneId information is not known.
arrival.longitude
Double

 (Optional)
The longitude of arrival area.
* Input when timestamp and zoneId information is not known.
arrival.address
String(256)

 (Optional)
The address of arrival area.
* 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 * See Barcode & QR Code Presentation.
barcode.errorCorrectionLevel
String(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.Interval
String(4)

 (Optional)
Update interval if support for dynamic updates.
Epoch timestamp in milliseconds.
privacyModeYn
String(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"
                }
            }
        ]
    }
}