| attributes.{fields}
|
title
String(32)
|
(Required)
Main title.
|
providerName
String(32)
|
(Required)
Provider name.
|
eventId
String(32)
|
(Optional)
Identifier for the event associated with the card.
|
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 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.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 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)
Formatted end time to display on the screen.
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
|
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.
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.
|
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 redundant data included for error correction.
QR codes support four error-correction levels.
• Code options: L/M/Q/H
|
noticeDesc
String(5000)
|
(Required)
Notice description.
* Long content is allowed.
* See Additional information format.
|
csInfo
String(5000)
|
(Optional)
Provider customer service information.
Provide the value as an escaped JSON string.
* Allowed items: calls, emails, or websites.
|
privacyModeYn
String(1)
|
(Optional)
Whether user authentication is required when using the card.
Either ‘Y’ or ‘N’.
* Default: ‘N’
|
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
|
noNetworkSupportYn
String(1)
|
(Optional)
Specifies whether the Wallet Card can be opened while the device is offline.
Either 'Y' or 'N'.
* Default: 'N'
|
appLinkLogo
String(256)
|
(Optional)
App link image URL.
The file size should not exceed 256 kB.
|
appLinkName
String(32)
|
(Optional)
App link name.
|
appLinkData
String(256)
|
(Optional)
Information about the partner app link.
|
locations
String(1024)
|
(Optional)
List of locations where the card can be used.
* See Locations format.
|
