Android
Uses NFC-F (FeliCa) via native transceive() APIs. Supported on Android API level 19 and newer.
Device and NFC Notes
Platform support model
Section titled “Platform support model”mrt_card_reader provides cross-platform support while handling platform NFC differences internally.
iOS
Uses FeliCa readWithoutEncryption() APIs (iOS 13+), with normalized output matching Android data shape.
Device reality checklist
Section titled “Device reality checklist”- Maintain a known-good test matrix for Android and iOS devices.
- Validate on real cards in commute conditions, not only in office demos.
- Track failed sessions with enough context (device, OS, timeout, error type).
- Keep scan UX resilient: cancellation and retries are normal behaviors.
UX signals that reduce support tickets
Section titled “UX signals that reduce support tickets”Immediate status feedback
Show clear messages like "Ready", "Scanning", "Card read", or specific error text from typed exceptions.
Deterministic session timeout
Use explicit timeout values so users never feel stuck in an endless scan state.
One-tap retry
For recoverable failures, keep users in flow with a retry action instead of forcing full navigation reset.
iOS hardware note
Section titled “iOS hardware note”FeliCa support requires compatible iPhone models (typically iPhone 7 or newer, excluding iPhone X per package docs). Always verify your target audience device mix before rollout.