BrightStar tickets use QR codes for secure, fast validation. This document covers the QR code specifications, security features, and customization options.
QR Code Format
Standard
Format: QR Code (ISO/IEC 18004)
Error correction: Level M (15%)
Version: Dynamic (based on data length)
Encoding: UTF-8
Dimensions
Minimum: 100x100 pixels
Recommended: 200x200 pixels
Print DPI: 300 minimum
Colors
Default: Black on white
Custom: Dark foreground on light background
Contrast ratio: 3:1 minimum
Data Structure
json
// QR Code payload structure
{
"v": 1, // Version
"t": "TKT-ABC123-XYZ", // Ticket ID (unique)
"e": "evt_123", // Event ID
"c": "a1b2c3d4", // Checksum (HMAC-SHA256)
"x": 1735689600 // Expiry timestamp
}
// Encoded as URL for fallback:
https://brightstarevents.com/t/TKT-ABC123-XYZ
// URL allows manual entry if QR failsQR code anatomy diagram
Interactive component coming soon
Security Features
Checksum Validation
Algorithm: HMAC-SHA256
Key: Event-specific secret
Prevents: Ticket ID guessing/modification
Expiry
Default: Event end + 24 hours
Custom: Configurable per event
One-Time Use
First scan: Valid
Subsequent scans: "Already checked in"
Exception: Re-entry mode (configurable)
Customization Options
Available customizations:
- Custom colors (maintain contrast)
- Logo overlay in center (up to 30% coverage)
- Custom shape (rounded corners)
- Branded ticket PDF template
- Apple Wallet / Google Wallet passes
Apple Wallet passes auto-surface based on location and time. Attendees arriving at your venue will see the ticket automatically on their lock screen.