NFC not available
Confirm NFC is enabled in device settings and the hardware supports NFC. On iOS, check model compatibility.
Troubleshooting
Common issues from package docs
Section titled “Common issues from package docs”Card reading timeout
Increase session timeout and ensure stable card placement near the reader area.
Invalid card errors
Verify the card is a Dhaka MRT Line 6 FeliCa card and not another transit profile.
Data corruption exception
Retry with another card or device. Damaged cards may return incomplete or malformed blocks.
iOS cannot read card
Recheck Info.plist values and ensure the NFC Tag Reading capability is enabled in Xcode.
Practical debugging checklist
Section titled “Practical debugging checklist”- Capture exception type and message in your logs.
- Include OS version and device model in scan telemetry.
- Record timeout value and elapsed scan duration.
- Track scan success rate by app version.
- Keep a known-good card in your QA toolkit for sanity checks.