Driver License PDF417 Glare and Blur Capture Guide

What the Failure Means

PDF417 stores data across many narrow bars and stacked rows. Glare can erase a band of rows, while motion blur merges neighboring bars and prevents a deterministic decode.

A Reliable Recovery Path

Use live capture guidance: diffuse light, hold steady, keep the card parallel, fill the frame without cropping, and preserve resolution during upload. Consult the PDF417 error reference for status codes and use the scanner with fictional or authorized samples while tuning capture guidance.

Where This Workflow Fits

• Diffuse lighting: Validate this condition before the image leaves the capture screen.
• Steady focus: Include this check in support guidance and quality monitoring.
• Card parallel to camera: Include this check in support guidance and quality monitoring.

Handle the Result Explicitly

Treat capture errors as application states. Never substitute guessed identity values when the barcode cannot be validated.

Prerequisite: A server-side API integration and a capture UI that can request a new license-back image

const captureRules = {
  maxBytes: 4_500_000,
  acceptedTypes: ["image/jpeg", "image/png", "image/webp"],
  requireFullCardBack: true,
  userPrompt: "Avoid glare and hold the camera steady",
};

Example Recoverable Error

This illustrative error contains no personal data. Use the error code, rather than free-form text, to select the next application action.

{
  "success": false,
  "error": "PDF417_NOT_DECODED",
  "message": "Upload a clear image of the complete back of the US driver license or State ID."
}