Clip

'Clip' cards can be grouped into representative cards for collections of various types. (Currently, Clip cards are limited to travel-related items only.)

Wallet Card Type

Wallet Card Sub Type

clip

businesstrips, trips, others

Businesstrips
Figure 1: Sample UI: Clip - Businesstrips

Trips
Figure 2: Sample UI: Clip - Trips

Others
Figure 3: Sample UI: Clip - 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.

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)

(Required)
Provider name.

startDate
Long(13)

(Required)
Start date (Display Start date)
Epoch timestamp in milliseconds.

startDate.utcOffset
String(8)

(Optional)
UTC offset of time at the start point.

startDate.zoneId
String(64)

(Required)
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"

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.

endDate.zoneId
String(64)

(Required)
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"

noticeDesc
String(1024)

(Required)
Notice description
* Long content is allowed.
* See Additional information format.

country
String(64)

(Optional)
Destination country.

city
String(64)

(Optional)
Destination city.

Example

{
  "card": {
    "type": "clip",
    "subType": "businesstrips",
    "data": [
      {
        "refId": "clip-001",
        "createdAt": 1672574400000,
        "updatedAt": 1672574400000,
        "language": "en",
        "attributes": {
          "title": "San Francisco Biz Trip",
          "appLinkLogo": "https://../applinklogo.png",
          "appLinkName": "OO Biz",
          "appLinkData": "https://www.oobiz.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-Biz",
          "startDate": 1735041600000,
          "startDate.utcOffset": "UTC-8",
          "startDate.zoneId": "America/Los_Angeles",
          "endDate": 1735675200000,
          "endDate.utcOffset": "UTC-8",
          "endDate.zoneId": "America/Los_Angeles",
          "noticeDesc": "{\"count\":1,\"info\":[{\"title\":\"NOTICE\",\"content\":[\"Check your itinerary before departure.\"]}]}",
          "country": "USA",
          "city": "San Francisco"
        }
      }
    ]
  }
}