Why Cropped Driver License PDF417 Barcodes Fail

What the Failure Means

Cropping through the first or last barcode columns, removing complete rows, or cutting away the symbol boundary can leave too little structure for reliable recovery.

A Reliable Recovery Path

Display a landscape guide with padding around the barcode, validate the preview before upload, and do not auto-crop tightly around uncertain barcode edges. 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

• Left and right edges visible: Validate this condition before the image leaves the capture screen.
• Top and bottom rows intact: Include this check in support guidance and quality monitoring.
• Landscape orientation: 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

function showCaptureMessage(result) {
  if (result?.error === "PDF417_NOT_DECODED") {
    return "Retake the full license back with space around every barcode edge.";
  }
  return null;
}

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."
}