ID Check — PDF417 Barcode Scan Step
Overview
The ID verification flow now includes a fourth step: scanning the PDF417 barcode on the back of the student's driver's license or state ID. This extracts machine-readable identity data (name, date of birth, expiry date, license number, state) from the AAMVA-standard barcode and saves it alongside the verification log for staff review.
Flow
- Step 1 — ID Front Photo: Back camera captures the front of the ID.
- Step 2 — Selfie: Front camera captures a face photo for comparison.
- Step 3 — Barcode Scan (new): If the ID was authenticated (
id_authentic=true), the back camera activates and ZXing scans continuously for a PDF417 barcode. Student can tap Skip — the step is non-blocking. - Step 4 — Outcome: Pass/review result shown; barcode data saved silently.
AAMVA Field Mapping
| Field | AAMVA Code(s) | Stored In |
|---|---|---|
| Full Name | DCS + DCT/DAC + DAD, or DAA | barcode_name |
| Date of Birth | DBB (MMDDYYYY) | barcode_dob |
| Expiry Date | DBA (MMDDYYYY) | barcode_expiry |
| License Number | DAQ or DCF | barcode_license |
| Issuing State | DAJ | barcode_state |
| Full raw payload | — | barcode_raw (audit) |
Technical Reference
- ZXing library:
@zxing/library@0.20.0loaded from jsDelivr CDN in web page HTML - Scanner:
ZXing.BrowserMultiFormatReaderwithPDF_417hint +TRY_HARDER - API:
idcheck_api.save_barcode_data(verification_log, barcode_raw, ...)— requires matching user or staff role - DocType:
ID Verification Log— new fields:sb_barcode,barcode_name/dob/expiry/license/state/raw - Shipped in v0.5.0, commit
c8309cc
Was this article helpful?