@netappsng/react-native-pay 0.1.1 → 0.2.2

package/Netappspay.podspec

@@ -16,7 +16,7 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
   s.private_header_files = "ios/**/*.h"
 
-  s.dependency "NetAppsPaySDK"
+  s.dependency "NetAppsPaySDK", '~> 1.0'
 
   install_modules_dependencies(s)
 end

package/README.md

@@ -16,7 +16,7 @@ yarn add @netappsng/react-native-pay
 cd ios && pod install
 ```
 
-The SDK uses the native [NetAppsPaySDK](https://gitlab.com/netapps-sdk/netappspay-sdk-ios) Swift package, which is linked automatically via CocoaPods.
+The SDK uses the native [NetAppsPaySDK](https://cocoapods.org/pods/NetAppsPaySDK) which is resolved automatically via CocoaPods.
 
 ### Android
 
@@ -187,25 +187,58 @@ Tap to Pay lets customers pay by tapping their contactless card on the Android d
 
 > **Not supported on iOS.** If you include `'tap_to_pay'` in `paymentChannels` on iOS, it is silently ignored.
 
-### Step 1 — Add the taptopay module dependency
+### Step 1 — Set minSdk to 28
+
+The NFC contactless SDK requires Android API 28+. Open your React Native project's Android build file and set `minSdkVersion`:
+
+```groovy
+// android/app/build.gradle
+
+android {
+    defaultConfig {
+        minSdkVersion 28  // Required for NFC contactless SDK
+    }
+}
+```
+
+### Step 2 — Add the taptopay module dependency
 
 In your React Native project's **Android** build files, add the `taptopay` module alongside the payment SDK:
 
-```kotlin
-// android/app/build.gradle.kts  (or build.gradle)
+```groovy
+// android/app/build.gradle
 
 dependencies {
     // The core payment SDK (already added by the RN package)
-    implementation("ng.netapps:netappspay:1.0.0")
+    implementation "ng.netapps:netappspay:1.1.0"
 
     // Tap to Pay NFC plugin — add this line
-    implementation("ng.netapps:taptopay:1.0.0")
+    implementation "ng.netapps:taptopay:1.0.0"
 }
 ```
 
 Then sync your Gradle project (Android Studio will prompt you, or run `cd android && ./gradlew sync`).
 
-### Step 2 — Register the NFC provider in your Android app
+### Step 3 — Fix the manifest merger conflict
+
+The POS SDK includes its own theme which conflicts with your app's theme. Add `tools:replace="android:theme"` to your `<application>` tag:
+
+```xml
+<!-- android/app/src/main/AndroidManifest.xml -->
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <application
+        android:theme="@style/AppTheme"
+        tools:replace="android:theme">
+        <!-- your activities -->
+    </application>
+</manifest>
+```
+
+> If your manifest already has an `<application>` tag with a theme, just add `xmlns:tools="http://schemas.android.com/tools"` to the `<manifest>` tag and `tools:replace="android:theme"` to the `<application>` tag.
+
+### Step 4 — Register the NFC provider in your Android app
 
 Open your `MainApplication.kt` (or `MainApplication.java`) file — this is usually at:
 
@@ -258,7 +291,7 @@ public class MainApplication extends Application implements ReactApplication {
 
 That's all the native code you need. The `taptopay` module's `AndroidManifest.xml` automatically adds the NFC permission with `android:required="false"`, so your app still installs on devices without NFC.
 
-### Step 3 — Include `'tap_to_pay'` in your payment channels
+### Step 5 — Include `'tap_to_pay'` in your payment channels
 
 Now in your React Native / TypeScript code, add `'tap_to_pay'` to the `paymentChannels` array:
 
@@ -297,15 +330,40 @@ presentPayment(config, {
 1. When the payment sheet opens, the SDK checks if a Tap to Pay provider is registered via `TapToPayRegistry`
 2. If registered **and** the device has NFC hardware enabled, the "Tap to Pay" tab appears
 3. If no provider is registered or the device lacks NFC, the tab is automatically hidden — no errors, no crashes
-4. The customer taps their contactless card on the device to complete payment
+4. The user selects their **Account Type** and **Device Type** using the chip controls on the Tap to Pay screen
+5. The customer taps their contactless card on the device to complete payment
+
+### Account Type
+
+The Tap to Pay screen presents a segmented chip control for account type selection:
+
+| Chip | Value |
+|------|-------|
+| **Default** | `DEFAULT_UNSPECIFIED` — the issuer's default account |
+| **Savings** | `SAVINGS` |
+| **Current** | `CURRENT` |
+| **Credit** | `CREDIT` |
+
+### Device Type
+
+A second chip control lets the user choose how the NFC card is read:
+
+| Chip | Description |
+|------|-------------|
+| **Internal NFC** | Uses the device's built-in NFC antenna (most common) |
+| **External** | Uses an external NFC reader connected to the device |
+| **NFC Kit** | Uses a third-party NFC kit module |
+
+The selected device type is **persisted automatically** — the SDK remembers the user's last choice across sessions so they don't have to re-select each time.
 
 ### Requirements
 
 | Requirement | Value |
 |---|---|
-| Min Android SDK | **24** (Android 7.0) |
-| NFC hardware | Required on the device |
+| Min Android SDK | **28** (Android 9.0) |
+| NFC hardware | Required on the device (for Internal NFC) |
 | `taptopay` module | Must be added as a dependency |
+| Manifest fix | `tools:replace="android:theme"` on `<application>` |
 | Provider registration | Must call `TapToPayRegistry.register()` before payment |
 
 ### Unregister (optional)
@@ -321,7 +379,7 @@ TapToPayRegistry.unregister()
 This package bridges the native NetAppsPay SDKs:
 
 - **iOS**: [NetAppsPaySDK](https://github.com/nicenapp/NetAppsPaySDK) (Swift Package)
-- **Android**: `ng.netapps:netappspay:1.0.0` (Maven Central)
+- **Android**: `ng.netapps:netappspay:1.1.0` (Maven Central)
 
 ## License
 

package/android/build.gradle

@@ -64,5 +64,5 @@ android {
 
 dependencies {
   implementation "com.facebook.react:react-android"
-  implementation "ng.netapps:netappspay:1.0.0"
+  implementation "ng.netapps:netappspay:1.1.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netappsng/react-native-pay",
-  "version": "0.1.1",
+  "version": "0.2.2",
   "description": "netapps payment sdk",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",