React Native

Integration time — 9 minutes.

GitHub - Tangem Card SDK React Native



iOS 13+ (CoreNFC is required), Xcode 12.5.1+ SDK can be imported to a project with target version iOS 11, but it will be able to work only from iOS 13.


Android with minimal SDK version of 21 and a device with NFC support.


npm install tangem-sdk-react-native-new

Android Notes

Add the following intent filters and metadata tag to your app AndroidManifest.xml

    <action android:name="android.nfc.action.NDEF_DISCOVERED"/>
    <category android:name="android.intent.category.DEFAULT"/>

    <action android:name="android.nfc.action.TECH_DISCOVERED"/>

<meta-data android:name="android.nfc.action.TECH_DISCOVERED" android:resource="@xml/nfc_tech_filter" />

Create the file android/src/main/res/xml/nfc_tech_filter.xml and add the following content:


Example AndroidManifest.xml

iOS Notes

  1. Add Swift Header Search Path to your app by following this steps:

    • Open ios/YourAppName.xcodeproj in Xcode

    • Right-click on Your App Name in the Project Navigator on the left, and click New File…

    • Create a single empty Swift file to the project (make sure that Your App Name target is selected when adding)

    • When Xcode asks, press Create Bridging Header and do not remove Swift file then.

  2. As React Native trying to link against an older Swift runtime while targeting a newer version of the OS. We need to remove swift linking from our project to be able to compile the SDK. apply below changes on your IOS project file (project.pbxproj)

    -  "\"$(TOOLCHAIN_DIR)/usr/lib/swift-5.0/$(PLATFORM_NAME)\"",
  3. Configure your app to detect NFC tags. Turn on Near Field Communication Tag Reading under the Capabilities tab for the project’s target (see Add a capability to a target).

  4. Add the NFCReaderUsageDescription key as a string item to the Info.plist file. For the value, enter a string that describes the reason the app needs access to the device’s NFC reader:

    <string>Some reason</string>
  5. In the Info.plist file, add the list of the application identifiers supported in your app to the ISO7816 Select Identifiers (AIDs) information property list key. The AIDs of Tangem cards are: A000000812010208 and D2760000850101.

  6. To prevent customers from installing apps on a device that does not support the NFC capability, add the following to the Info.plist code (Optional):


Next steps:

pageScan cardpageSign data

Last updated