Passmint
TemplatesDocsPricingBlog
Log inGet started
Passmint

Apple and Google Wallet passes from one API. Built for people who ship.

Product
  • Pass Designer
  • Developers
  • Distribution
  • Analytics
  • Templates
  • Pricing
Developers
  • Documentation
  • API reference
  • Node SDK
  • Webhooks
Company
  • Changelog
  • About
  • Contact
  • Support
  • Security
  • Terms
  • Privacy
Social
  • GitHub
  • X

© 2026 Passmint. Built for indie makers.

Apple Wallet & Google Wallet, one API.

Troubleshooting

The barcode won't scan or looks dim

Updated June 29, 2026

A barcode that won't scan is usually one of two things: a display issue on the phone, or a pass that's no longer valid. Here's how to tell them apart.

If you're showing the pass

  • Turn up your screen brightness. A dim screen is the most common reason a scanner struggles. Phones usually brighten the screen automatically when you open a pass, but bright sunlight or low power mode can work against it.
  • Hold the phone flat and steady, a comfortable distance from the scanner, and let it focus.
  • Clean your screen. Smudges and a heavy screen protector can scatter the laser or camera enough to matter.
  • Open the pass fully rather than glancing at a lock-screen preview, so the whole barcode is on screen.

If it still won't scan

If the display is fine and it still won't read, the pass itself may no longer be valid:

  • It may have already been redeemed. Many passes are single-use and won't scan a second time.
  • It may have expired. Check the pass details for a valid date or time.

In either case, contact the business that issued the pass. They can confirm its status and re-issue it if it should still work.

If you issued the pass

  • Confirm the format matches your scanner. A scanner set up for one barcode type won't read another. Check your template's barcode format against what your hardware expects. See barcodes on passes.
  • Check the encoded value. If the barcode message references a field that was empty when the pass was issued, the barcode may encode the wrong value. Mark fields that feed the barcode as required.

Always scan a real issued pass with the actual scanner before going live, especially when a third-party system reads the code. On-screen previews don't prove the scanner is configured for your value.

Related articles

My pass isn't updatingWhy a changed pass hasn't refreshed on a phone yet, for holders and issuers.My pass won't install (iPhone)Common reasons an Apple Wallet pass won't add, and how to fix each.

On this page

  • If you're showing the pass
  • If it still won't scan
  • If you issued the pass