Skip to content
HeartBadge docs

Badge Card and Barcode

Live

The visual surface of your badge: what you see, what you scan, how verification works.

Your badge card is the visual representation of your membership. It shows your 20-digit identifier, your program branding, and your current HRTB level. At the bottom of the card is a rotating barcode that operators scan to verify your presence and trigger rewards.

The card

The badge card displays:

  • Program branding. The name and visual identity of the program you joined (the festival, club, or operator).
  • Your badge identifier. The 20-digit, Luhn-checksummed number that uniquely identifies your badge. See Badge Identifier.
  • Your HRTB level. The tier (1×, 1.5×, 2×, 3×) that multiplies your earnings.

The barcode

The barcode at the bottom of the card rotates every 30 seconds. This is intentional — a static barcode could be photographed and reused by someone else. The rotation ensures that only someone with current access to your badge can present a valid scan.

How rotation works: The barcode encodes your badge identifier plus a time-based component. The operator's reader checks that the time component is recent (within the current or previous window) and that the badge identifier is valid. If both conditions pass, the scan succeeds.

How scanning works

  1. You present your badge card. Open the app and show the barcode to the operator's reader (a phone, a tablet, or a dedicated scanner).
  2. The reader verifies. The reader decodes the barcode, checks the time window, and verifies the badge identifier. This verification can happen offline using SPV proofs that travel with the badge — no round trip to a server required.
  3. The event is recorded. A successful scan triggers a check-in event. Depending on the program configuration, this may dispatch rewards to your wallet, advance your HRTB status, or simply log your presence.

Offline verification

Festivals don't always have signal. Fareboxes can't wait for a round trip to the cloud. HeartBadge is designed to verify at the edge. The badge carries its own proofs (SPV + BEEF), and the reader can verify them locally. A scan on Sunday night with no Wi-Fi still resolves to a reward on Monday morning once connectivity returns.

Technical deep dive: SPV and Offline.

NFC (coming soon)

The rotating barcode is the current scan method. NFC support — tap your phone to a reader — is rolling out. See Apple Wallet and Google Wallet.