1. Requirements
- A browser and environment that supports WebHID.
- A compatible MagTek reader connected by USB.
- User permission granted to the device when prompted by the browser.
- Test mDL/Digital ID credential ready for tap/scan presentation.
2. Quick Start
3. Main Controls (Top Panel)
These controls manage reader connectivity and session state so operators can start cleanly, recover quickly, and keep transaction flow predictable.
- Open: Establishes a connection to a selected HID device. Benefit: quickly moves the station from idle to ready-to-verify.
- Close: Closes the active HID connection. Benefit: safely ends a session before device handoff, restart, or troubleshooting.
- Clear: Clears current command/data display state in the UI. Benefit: removes stale results so each new read is easier to interpret.
- Command Center: Opens the side panel for template and manual command dispatch. Benefit: gives one place to start age-check, KYC, or custom test flows.
4. Command Center Workflow
The Command Center is where you initiate verification requests. It standardizes request setup so operators can run repeatable checks with fewer manual errors.
- Select Template Command: choose from predefined requests such as Age Verify, KYC, or Cancel Request. Benefit: speeds common tasks and keeps command format consistent.
- Configure Options: opens command configuration flow for custom options. Benefit: allows controlled flexibility without rewriting payloads by hand.
- Manual Hex Command: optional direct hex entry for advanced testing. Benefit: supports engineering validation, edge-case simulation, and protocol debugging.
- Send Command: sends the selected or entered payload to the connected reader. Benefit: provides immediate command dispatch to start the credential interaction.
If no device is open, commands will not proceed. Connect first with Open.
5. View Modes
Each view presents the same transaction from a different operational perspective, helping different roles make decisions faster.
- Digital License Card: visual credential card with core identity fields and portrait. Benefit: gives frontline staff a quick human-readable confirmation view.
- Data Structure: parsed response output tree/content. Benefit: improves troubleshooting by exposing raw parsed values and hierarchy.
- Summary Table: structured data attributes table. Benefit: makes audits and field-by-field review easier than scanning raw payload output.
- Age Verification: age verification snapshot panel (when enabled in config). Benefit: supports rapid pass/fail age checks for restricted transactions.
- Verification Receipt: transaction receipt card and secure verification summary. Benefit: creates a clear proof artifact for compliance and operator records.
- KYC Profile: identity profile plus export tools. Benefit: consolidates identity details for onboarding, review, or downstream systems.
- Map: residence/address map preview from available address fields. Benefit: adds geographic context that can help detect entry mistakes or anomalies.
6. Output and Export
Export features let teams preserve evidence, share data with operations, and reduce re-entry effort.
- Receipt view supports Download PNG Receipt. Benefit: enables fast record capture for audit trails and customer-service follow-up.
- KYC view supports Save Portrait as PNG, Export JSON, Export CSV File, and Copy CSV Clipboard. Benefit: simplifies handoff to reporting, case management, and back-office processing.
- Section headers include collapse/expand toggles for cleaner operator workflow. Benefit: reduces clutter and helps users focus on the active step.
7. Status and Console
Live status surfaces reduce guesswork during device operations and shorten time to resolution when something fails.
- The top-right status pill reflects device state (Disconnected or Connected). Benefit: confirms readiness before sending commands.
- A bottom response console panel is available to inspect device display/log output during transactions. Benefit: helps support teams diagnose issues from live feedback.
- The transaction modal prompts when the app is waiting for an mDL/Digital ID presentation. Benefit: provides clear operator guidance at the exact moment user action is required.
8. Troubleshooting
- Open does nothing: verify USB connection and browser permission to access the HID device.
- Cannot send command: open a device first, then retry from Command Center.
- No data after tap/scan: confirm the correct command template was sent and present the credential again.
- Blank Map/Receipt/KYC: these panels populate only after a successful response containing the required fields.
- Need to reset quickly: use Clear, then resend a template command.