// the find
square/react-native-square-reader-sdk
React Native Plugin for Square Reader SDK
A React Native bridge to Square's Reader SDK, letting mobile apps accept card-present payments via Square hardware. It's for US-based merchants building point-of-sale apps who are already committed to Square's ecosystem and want to avoid writing native modules themselves.
The bridge covers the full payment flow — authorization, checkout, reader settings, and stored cards — without you writing a line of Java or Objective-C. The quickstart app is unusually complete for a vendor plugin, with real screens for QR auth, manual auth, and checkout flows. TypeScript definitions ship in index.d.ts, so you get type safety without hunting for a @types package. Error handling uses a converter pattern on both platforms that maps native SDK error codes to consistent JS objects rather than leaking platform-specific strings.
US-only — the README is upfront about this, but it kills the plugin for most international developers outright. The Android build requirements (API 30, build tools 28.0.3, Gradle Plugin 3.0.0) are years out of date and will clash with any app targeting current Android targets. Square enforces a mandatory SDK update policy meaning you can be blocked from processing payments if you don't keep the dependency current, which is an operational risk most teams don't account for at adoption time. 118 stars for a first-party Square repo suggests this isn't being actively used or promoted — the Flutter version likely got all the attention.