{"id":13514933,"url":"https://github.com/square/react-native-square-reader-sdk","last_synced_at":"2025-06-13T01:38:57.793Z","repository":{"id":33049199,"uuid":"145025903","full_name":"square/react-native-square-reader-sdk","owner":"square","description":"React Native Plugin for Square Reader SDK","archived":false,"fork":false,"pushed_at":"2025-03-21T21:51:15.000Z","size":3266,"stargazers_count":116,"open_issues_count":13,"forks_count":37,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-06-10T18:01:32.288Z","etag":null,"topics":["payment","react-native","reader-sdk","sdk","square"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/square.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-16T18:36:59.000Z","updated_at":"2025-04-14T19:18:30.000Z","dependencies_parsed_at":"2024-06-07T11:26:45.285Z","dependency_job_id":"30a54843-6940-4083-b118-100e890ecb67","html_url":"https://github.com/square/react-native-square-reader-sdk","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/square/react-native-square-reader-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Freact-native-square-reader-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Freact-native-square-reader-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Freact-native-square-reader-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Freact-native-square-reader-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/square","download_url":"https://codeload.github.com/square/react-native-square-reader-sdk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Freact-native-square-reader-sdk/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259562793,"owners_count":22877080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["payment","react-native","reader-sdk","sdk","square"],"created_at":"2024-08-01T05:01:04.056Z","updated_at":"2025-06-13T01:38:57.743Z","avatar_url":"https://github.com/square.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"# React Native plugin for Reader SDK\n\n[![Build Status](https://travis-ci.com/square/react-native-square-reader-sdk.svg?branch=master)](https://travis-ci.com/square/react-native-square-reader-sdk)\n[![npm version](https://badge.fury.io/js/react-native-square-reader-sdk.svg)](https://badge.fury.io/js/react-native-square-reader-sdk)\n\nThis repo contains a React Native plugin for Square [Reader SDK]. Reader SDK for\nReact Native supports the following native Reader SDK versions:\n\n  * iOS: 1.7.2 and above\n  * Android: 1.7.5 and above\n\n\u003eThis plugin loads latest version of native Reader SDK by default according to [update policy for Reader SDK].\n\n## In this repo\n\nIn addition to the standard React Native directories, this repo includes:\n\n* `docs` - Documentation for the React Native plugin, including a\n  [getting started guide], [technical reference], and [troubleshooting guide].\n* [`reader-sdk-react-native-quickstart`] - A React Native sample app with\n  walkthrough.\n\n\n## Build requirements\n\n### Android\n\n* minSdkVersion is API 24 or higher.\n* Android SDK platform: API 30.\n* Android SDK build tools: 28.0.3\n* Android Gradle Plugin: 3.0.0 or greater.\n* Support library: 28.0.0\n* Google Play Services: 16.0.1\n* Google APIs Intel x86 Atom_64 System Image\n\n### iOS\n\n* Xcode version: 10.2 or greater.\n* iOS Base SDK: 11.1 or greater.\n* Deployment target: iOS 11.0 or greater.\n\n\n## Reader SDK requirements and limitations\n\n* Reader SDK is **only** available for accounts based in the **United States**.\n  Authorization requests for accounts based outside the United States return an\n  error.\n* Reader SDK may not be used for unattended terminals. Using Reader SDK to\n  implement payment solutions in unattended terminals or kiosks (for example,\n  vending machines) is strictly prohibited.\n* Reader SDK requires an authorization token from the [Mobile Authorization API]\n  to connect Square Readers and accept payments.\n* Reader SDK only supports on-screen tipping. Digital receipts and tips can be\n  configured in Reader SDK. Tipping on printed receipts is not supported at this\n  time.\n* Reader SDK cannot issue refunds. Refunds can be issued programmatically using\n  the Refunds API or manually in the [Square Dashboard].\n* Reader SDK is not supported in the Square sandbox. See [Testing Mobile Apps]\n  for testing recommendations.\n* Your version of Reader SDK must adhere to the Square SDK update policy. To\n  limit risk to developers and their users, Square enforces an\n  [update policy for Reader SDK] that requires developers to keep their version\n  of Reader SDK current.\n\n\n## License\n\n```\nCopyright 2019 Square Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n\n\n[//]: # \"Link anchor definitions\"\n[Mobile Authorization API]: https://developer.squareup.com/docs/mobile-authz/build-with-mobile-authz\n[Reader SDK]: https://developer.squareup.com/docs/reader-sdk/what-it-does\n[Square Dashboard]: https://squareup.com/dashboard/\n[update policy for Reader SDK]: https://developer.squareup.com/docs/reader-sdk/what-it-does#readersdkupdatepolicy\n[Testing Mobile Apps]: https://developer.squareup.com/docs/testing/mobile\n[getting started guide]: https://github.com/square/react-native-square-reader-sdk/tree/master/docs/get-started.md\n[technical reference]: https://github.com/square/react-native-square-reader-sdk/tree/master/docs/reference.md\n[troubleshooting guide]: https://github.com/square/react-native-square-reader-sdk/tree/master/docs/troubleshooting.md\n[`reader-sdk-react-native-quickstart`]: https://github.com/square/react-native-square-reader-sdk/tree/master/reader-sdk-react-native-quickstart\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquare%2Freact-native-square-reader-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquare%2Freact-native-square-reader-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquare%2Freact-native-square-reader-sdk/lists"}