Barcode & QR Code Presentation

This section describes how to define and configure Barcode and QR Code data for Samsung Wallet cards.
Developers can use this guide to understand the supported formats, data structures, and usage examples when integrating barcode or QR-based cards.

Card Data Format

Overview

Barcode and QR Code data are defined using a set of barcode.* fields.
These fields determine what is displayed, how it is displayed, and which barcode or QR format is used.

The configuration consists of the following components:

• Presentation Type (barcode.serialType)
• Presentation Format (barcode.ptFormat)
• Barcode / QR Format (barcode.ptSubFormat)

Barcode Data Structure

[Example]

{
  "barcode.value": "www.samsung.com",
  "barcode.serialType": "BARCODE",
  "barcode.ptFormat": "BARCODESERIAL",
  "barcode.ptSubFormat": "UPC_A"
}

Field Description

Artifact	Required	Description
barcode.value	Yes	Actual value to be encoded in the barcode or QR code
barcode.serialType	Yes	Type of data to be displayed (Barcode, QR code, Serial number, etc.)
barcode.ptFormat	Yes	Display format (barcode only, barcode with serial, QR only, etc.)
barcode.ptSubFormat	Optional	Barcode or QR code specification
barcode.interval	Optional	Validity period (in seconds) for Dynamic QR

Presentation Types (barcode.serialType)

Defines what kind of data is presented.

Code Name	Description
SERIALNUMBER	Displays a serial number
BARCODE	Displays a 1D barcode
QRCODE	Displays a QR code
SHIPPING	Shipping information (online use only)
CALLORDER	Call order information (online use only)
URL	URL serial (online use only)

Presentation Formats (barcode.ptFormat)

Defines how the data is visually displayed.

Code Name	Description
BARCODE	Barcode only
BARCODESERIAL	Barcode with serial number
SERIAL	Serial number only
DUALSERIAL	Dual serial numbers
DUALBARCODE	Dual barcodes
DUALBARCODESERIAL	Dual barcodes for each serial number
BARCODEPIN	Barcode with PIN
QRCODE	QR code only
QRCODESERIAL	QR code with serial number
BARCODE	Barcode only
BARCODESERIAL	Barcode with serial number

Barcode / QR Formats (barcode.ptSubFormat)

Defines the actual barcode or QR encoding format.
All formats are supported by the ZXing barcode scanning library.

[1D Barcode / QR Formats]

Code Name	Description
CODABAR	CODABAR 1D format
CODE_39	Code 39 1D format
CODE_93	Code 93 1D format
CODE_128	Code 128 1D format
EAN_8	EAN-8 1D format
EAN_13	EAN-13 1D format
ITF	Interleaved Two of Five
RSS_14	RSS-14
RSS_EXPANDED	RSS Expanded
UPC_A	UPC-A 1D format
UPC_E	UPC-E 1D format
UPC_EAN_EXTENSION	UPC/EAN extension (not stand-alone)

[2D Barcode / QR Formats]

Code Name	Description
QR_CODE	QR Code 2D format
AZTEC	Aztec 2D barcode format
DATA_MATRIX	Data Matrix 2D format
MAXICODE	MaxiCode 2D format
PDF_417	PDF417 format

Data Sample

1D Barcode with Serial (UPC-A)

[Example]

{
  "barcode.value": "www.samsung.com",
  "barcode.serialType": "BARCODE",
  "barcode.ptFormat": "BARCODESERIAL",
  "barcode.ptSubFormat": "UPC_A"
}

2D Barcode as QR Code

[Example]

{
  "barcode.value": "www.samsung.com",
  "barcode.serialType": "QRCODE",
  "barcode.ptFormat": "QRCODE",
  "barcode.ptSubFormat": "QR_CODE"
}

Dynamic QR Code (AZTEC, 300 seconds validity)

[Example]

{
  "barcode.value": "www.samsung.com",
  "barcode.serialType": "QRCODE",
  "barcode.ptFormat": "QRCODE",
  "barcode.ptSubFormat": "AZTEC",
  "barcode.interval": "300"
}

Serial Number Only

[Example]

{
  "barcode.value": "1234567890",
  "barcode.serialType": "SERIALNUMBER",
  "barcode.ptFormat": "SERIAL"
}

Developer Notes

• Ensure that serialType, ptFormat, and ptSubFormat are logically compatible
• Use barcode.interval only for Dynamic QR scenarios
• Always validate supported formats based on ZXing specifications
• All barcode data must be transmitted as an escaped JSON string