| attributes.{fields}
|
title
String(32)
|
(Required)
Main title
|
providerName
String(32)
|
(Required)
Provider name.
|
eventId
String(32)
|
(Optional)
Event Identifier
|
groupingId
String(32)
|
(Optional)
Identifier used to group related cards.
|
mainImg
String(256)
|
(Required)
URL for main generic image.
The file size should not exceed 512 kB.
|
startDate
Long(13)
|
(Required)
Start date (Display Start date)
Epoch timestamp in milliseconds.
|
startDate.relativeNotiTime
String(4)
|
(Optional)
The relative time from startDate
in minutes to provide a notification to the user
e.g., 5, 10, 15, 30, 60, and up to 2880
|
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 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.relativeNotiTime
String(4)
|
(Optional)
The relative time from endDate
in minutes to provide a notification to the user
e.g., 5, 10, 15, 30, 60, and up to 2880
|
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.
|
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
|
bgImage
String(256)
|
(Optional)
Card background image URL
The file size should not exceed 512 kB
The recommended size for image resources is 888 x 555 px
|
extendedFields
String(1024)
|
(Optional)
A flexible list of key-value pairs.
* See Extended Fields
|
providerViewLink
Object Array(4096)
|
(Optional)
A list of links that allow a content provider to expose additional information or related actions to the user.
Up to 5 links are supported.
* See Links format
|
text{i}
String(64)
|
(Optional)
Text item
i: 1~12
|
image1
String(128k)
|
(Optional)
Image item
Use only type 3
|
image1.lightUrl
String(256)
|
(Optional)
Image item in light mode
|
image1.darkUrl
String(256)
|
(Optional)
Image item in dark mode
|
image1.status
String(16)
|
(Optional)
Image item status
|
serial{i}.value
String(4096)
|
(Optional)
Actual data that is delivered when the barcode/QR code is scanned.
i: 1~2
|
serial{i}.serialType
String(32)
|
(Optional)
Presentation Type
e.g., SERIALNUMBER, BARCODE, ...
* See Barcode & QR Code Presentation.
|
serial{i}.ptFormat
String(32)
|
(Optional)
Presentation Format
e.g., BARCODE, QRCODE, SERIAL, ...
* See Barcode & QR Code Presentation.
|
serial{i}.ptSubFormat
String(32)
|
(Optional)
Presentation Sub-format
e.g., CODE_128, QR_CODE, ...
* See Barcode & QR Code Presentation.
|
serial{i}.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
|
noticeDesc
String(1024)
|
(Required)
Notice description
* Long content is allowed.
* See Additional Information format.
|
csInfo
String(512)
|
(Optional)
Providers’ customer service Information
Using data in JSON format converted to escape string
* Allowed items: calls, emails, or websites
|
privacyModeYn
String(1)
|
(Optional)
Whether or not to require user
authentication when using the card
Either ‘Y’ or ‘N’
* Default: ‘N’
|
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
|
noNetworkSupportYn
String(1)
|
(Optional)
Sets whether to support to open
the wallet card under 'No Network' Status.
Either 'Y' or 'N'
* Default: 'N'
|
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.
|
locations
String(1024)
|
(Optional)
List of locations where the card can be used.
* See Location format.
|
