Capacitor

Integration time — 8 minutes.

GitHub - Tangem Card SDK Capacitor

Requirements

iOS

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

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

Installation

To install this plugin to you project run next comman line commands:

npm install tangem-sdk
npx cap sync

Cordova platform should do all the configurations by itself.

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).

When you adding Near Field Communication Tag Reading capability, Xcode generates entries in *.entitlement file. You should check that there are only the Tag string in com.apple.developer.nfc.readersession.formats array. Otherwise AppStore will reject your build when you try to upload it.

<key>com.apple.developer.nfc.readersession.formats</key>
<array>
    <string>TAG</string>
</array>

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:

<key>NFCReaderUsageDescription</key>
<string>To scan NFC smart cards</string>

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.

<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
    <array>
        <string>A000000812010208</string>
        <string>D2760000850101</string>
    </array>

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

<key>UIRequiredDeviceCapabilities</key>
    <array>
        <string>nfc</string>
    </array>

Last updated