square · cesar-sosa-hol · Apr 26, 2026 · Apr 20, 2026 · Apr 21, 2026 · Apr 21, 2026
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -43,7 +43,7 @@ The SDK follows a standard React Native bridge pattern with four feature manager
 
 ## Platform Constraints
 
-- **iOS**: Min deployment target 16. Depends on `SquareMobilePaymentsSDK ~> 2.4.0` and `MockReaderUI ~> 2.4.0`.
+- **iOS**: Min deployment target 16. Depends on `SquareMobilePaymentsSDK ~> 2.5.0` and `MockReaderUI ~> 2.5.0`.
 - **Android**: Min SDK 28, Compile/Target SDK 35. Kotlin 2.2.21. Proguard must be disabled (`minifyEnabled: false`).
 - **Kotlin 2.2.x**: React Native 0.75.x Gradle plugin doesn't natively support Kotlin 2.2.x — requires `patch-package` workaround (see `docs/KOTLIN_COMPATIBILITY.md`).
 - Not compatible with Expo Go (requires native code).

diff --git a/README.md b/README.md
@@ -4,8 +4,8 @@
 
 Mobile Payments SDK for React Native supports the following SDK versions:
 
-  * [iOS](https://developer.squareup.com/docs/mobile-payments-sdk/ios#1-install-the-sdk-and-dependencies): 2.4.0 and above
-  * [Android](https://developer.squareup.com/docs/mobile-payments-sdk/android#1-install-the-sdk-and-dependencies): 2.4.0 and above
+  * [iOS](https://developer.squareup.com/docs/mobile-payments-sdk/ios#1-install-the-sdk-and-dependencies): 2.5.0 and above
+  * [Android](https://developer.squareup.com/docs/mobile-payments-sdk/android#1-install-the-sdk-and-dependencies): 2.5.0 and above
 
 ## Review requirements
 Before getting started, please review the Requirements and Limitations and Device Compatibility sections to ensure that the SDK can be used in your project:
@@ -14,7 +14,7 @@ Before getting started, please review the Requirements and Limitations and Devic
 
 ## Android: Kotlin 2.2.x Compatibility
 
-Mobile Payments SDK 2.4.0 requires Kotlin 2.2.21, which is not yet supported by React Native's Gradle plugin (0.75.x and earlier). Android builds will fail unless you apply a small patch to your project. See the [Kotlin Compatibility Workaround](docs/KOTLIN_COMPATIBILITY.md) for step-by-step instructions.
+Mobile Payments SDK 2.5.0 requires Kotlin 2.2.21, which is not yet supported by React Native's Gradle plugin (0.75.x and earlier). Android builds will fail unless you apply a small patch to your project. See the [Kotlin Compatibility Workaround](docs/KOTLIN_COMPATIBILITY.md) for step-by-step instructions.
 
 ## Installation
 ```sh

diff --git a/android/build.gradle b/android/build.gradle
@@ -88,7 +88,7 @@ repositories {
 }
 
 def kotlin_version = getExtOrDefault("kotlinVersion")
-def squareSdkVersion = "2.4.0"
+def squareSdkVersion = "2.5.0"
 
 dependencies {
   // For < 0.71, this will be from the local maven repo

diff --git a/android/src/main/java/com/mobilepaymentssdkreactnative/Utils.kt b/android/src/main/java/com/mobilepaymentssdkreactnative/Utils.kt
@@ -292,15 +292,10 @@ private fun Card.Brand.toBrandString(): String =
     Card.Brand.JCB -> "JCB"
     Card.Brand.CHINA_UNIONPAY -> "CHINA_UNIONPAY"
     Card.Brand.SQUARE_GIFT_CARD -> "SQUARE_GIFT_CARD"
-    Card.Brand.ALIPAY -> "ALIPAY"
-    Card.Brand.CASH_APP -> "CASH_APP"
     Card.Brand.EFTPOS -> "EFTPOS"
     Card.Brand.FELICA -> "FELICA"
     Card.Brand.INTERAC -> "INTERAC"
     Card.Brand.SQUARE_CAPITAL_CARD -> "SQUARE_CAPITAL_CARD"
-    Card.Brand.SUICA -> "SUICA"
-    Card.Brand.ID -> "ID"
-    Card.Brand.QUICPAY -> "QUICPAY"
   }
 
 private fun Card.CoBrand.toCoBrandString(): String =
@@ -356,8 +351,10 @@ fun ReaderInfo.toReaderInfoMap(): WritableMap {
     putString("serialNumber", serialNumber)
     putString("name", name)
     putMap("batteryStatus", batteryStatus?.toBatteryStatusMap())
-    putString("firmwareVersion", firmwareVersion)
-    putInt("firmwarePercent", firmwarePercent ?: 0)
+    putMap(
+      "firmwareInfo",
+      firmwareInfo.toFirmwareInfoMap()
+    )
     putArray("supportedCardEntryMethods", WritableNativeArray().apply {
       supportedCardEntryMethods.forEach {
         pushString(it.toEntryMethodString())
@@ -368,6 +365,21 @@ fun ReaderInfo.toReaderInfoMap(): WritableMap {
   }
 }
 
+fun ReaderInfo.ReaderFirmwareInfo.toFirmwareInfoMap(): WritableMap  {
+  return WritableNativeMap().apply {
+    putString("version", version)
+    putInt("updatePercentage", updateStatus.toPercent() ?: 0)
+  }
+}
+
+fun  ReaderInfo.FirmwareUpdateStatus.toPercent() : Int? {
+    return when(this) {
+      is ReaderInfo.FirmwareUpdateStatus.None -> null
+      is ReaderInfo.FirmwareUpdateStatus.InProgress -> this.updatePercentage
+      is ReaderInfo.FirmwareUpdateStatus.Pending -> null
+    }
+}
+
 fun CardEntryMethod.toEntryMethodString(): String {
   return when(this) {
     CardEntryMethod.EMV -> "EMV"

diff --git a/docs/KOTLIN_COMPATIBILITY.md b/docs/KOTLIN_COMPATIBILITY.md
@@ -1,8 +1,8 @@
 # Kotlin 2.2.x Compatibility Workaround for React Native
 
-Mobile Payments SDK 2.4.0 requires **Kotlin 2.2.21**, which introduces a breaking change with React Native's Gradle plugin (versions 0.75.x and earlier). The `KotlinTopLevelExtension` class was removed in Kotlin 2.2.x, causing the Android build to fail during Gradle configuration.
+Mobile Payments SDK 2.5.0 requires **Kotlin 2.2.21**, which introduces a breaking change with React Native's Gradle plugin (versions 0.75.x and earlier). The `KotlinTopLevelExtension` class was removed in Kotlin 2.2.x, causing the Android build to fail during Gradle configuration.
 
-This guide explains how to apply a patch to your project so you can use Mobile Payments SDK 2.4.0 with React Native until React Native itself adds support for Kotlin 2.2.x.
+This guide explains how to apply a patch to your project so you can use Mobile Payments SDK 2.5.0 with React Native until React Native itself adds support for Kotlin 2.2.x.
 
 > **Note:** This workaround is temporary. Once React Native releases a version with Kotlin 2.2.x support, you can remove the patch and `patch-package` dependency.
 
@@ -111,7 +111,7 @@ Applying patches...
 
 ### 5. Build your project
 
-Your Android build should now succeed with Kotlin 2.2.21 and Mobile Payments SDK 2.4.0.
+Your Android build should now succeed with Kotlin 2.2.21 and Mobile Payments SDK 2.5.0.
 
 ## Removing the Workaround
 

diff --git a/example/android/app/build.gradle b/example/android/app/build.gradle
@@ -120,14 +120,15 @@ android {
     packaging {
         resources {
             excludes += "/META-INF/{AL2.0,LGPL2.1}"
+            pickFirsts += "META-INF/versions/9/OSGI-INF/MANIFEST.MF"
         }
     }
 }
 
 dependencies {
     // The version of react-native is set by the React Native Gradle Plugin
     implementation("com.facebook.react:react-android")
-    // Mobile Payments SDK 2.4.0
+    // Mobile Payments SDK 2.5.0
     implementation("com.squareup.sdk:mobile-payments-sdk:$squareSdkVersion")
     implementation("com.squareup.sdk:mockreader-ui:$squareSdkVersion")
     if (hermesEnabled.toBoolean()) {

diff --git a/example/android/build.gradle b/example/android/build.gradle
@@ -6,7 +6,7 @@ buildscript {
         targetSdkVersion = 35
         ndkVersion = "26.1.10909125"
         kotlinVersion = "2.2.21"
-        squareSdkVersion = "2.4.0"
+        squareSdkVersion = "2.5.0"
     }
     repositories {
         google()

diff --git a/example/ios/MobilePaymentsSdkReactNativeExample.xcodeproj/project.pbxproj b/example/ios/MobilePaymentsSdkReactNativeExample.xcodeproj/project.pbxproj
@@ -338,14 +338,10 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests-resources-${CONFIGURATION}-input-files.xcfilelist",
 			);
-			inputPaths = (
-			);
 			name = "[CP] Copy Pods Resources";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests-resources-${CONFIGURATION}-output-files.xcfilelist",
 			);
-			outputPaths = (
-			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests-resources.sh\"\n";
@@ -359,14 +355,10 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample/Pods-MobilePaymentsSdkReactNativeExample-resources-${CONFIGURATION}-input-files.xcfilelist",
 			);
-			inputPaths = (
-			);
 			name = "[CP] Copy Pods Resources";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample/Pods-MobilePaymentsSdkReactNativeExample-resources-${CONFIGURATION}-output-files.xcfilelist",
 			);
-			outputPaths = (
-			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample/Pods-MobilePaymentsSdkReactNativeExample-resources.sh\"\n";
@@ -419,14 +411,10 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests-frameworks-${CONFIGURATION}-input-files.xcfilelist",
 			);
-			inputPaths = (
-			);
 			name = "[CP] Embed Pods Frameworks";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests-frameworks-${CONFIGURATION}-output-files.xcfilelist",
 			);
-			outputPaths = (
-			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests/Pods-MobilePaymentsSdkReactNativeExample-MobilePaymentsSdkReactNativeExampleTests-frameworks.sh\"\n";
@@ -440,14 +428,10 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample/Pods-MobilePaymentsSdkReactNativeExample-frameworks-${CONFIGURATION}-input-files.xcfilelist",
 			);
-			inputPaths = (
-			);
 			name = "[CP] Embed Pods Frameworks";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample/Pods-MobilePaymentsSdkReactNativeExample-frameworks-${CONFIGURATION}-output-files.xcfilelist",
 			);
-			outputPaths = (
-			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-MobilePaymentsSdkReactNativeExample/Pods-MobilePaymentsSdkReactNativeExample-frameworks.sh\"\n";

diff --git a/example/ios/Podfile.lock b/example/ios/Podfile.lock
@@ -7,11 +7,11 @@ PODS:
   - hermes-engine (0.75.3):
     - hermes-engine/Pre-built (= 0.75.3)
   - hermes-engine/Pre-built (0.75.3)
-  - mobile-payments-sdk-react-native (2026.2.1):
+  - mobile-payments-sdk-react-native (2026.3.4):
     - DoubleConversion
     - glog
     - hermes-engine
-    - MockReaderUI (~> 2.4.0)
+    - MockReaderUI (~> 2.5.0)
     - RCT-Folly (= 2024.01.01.00)
     - RCTRequired
     - RCTTypeSafety
@@ -28,9 +28,9 @@ PODS:
     - ReactCodegen
     - ReactCommon/turbomodule/bridging
     - ReactCommon/turbomodule/core
-    - SquareMobilePaymentsSDK (~> 2.4.0)
+    - SquareMobilePaymentsSDK (~> 2.5.0)
     - Yoga
-  - MockReaderUI (2.4.0)
+  - MockReaderUI (2.5.0)
   - Permission-BluetoothPeripheral (3.10.1):
     - RNPermissions
   - Permission-LocationAccuracy (3.10.1):
@@ -1581,7 +1581,7 @@ PODS:
     - ReactCommon/turbomodule/core
     - Yoga
   - SocketRocket (0.7.0)
-  - SquareMobilePaymentsSDK (2.4.0)
+  - SquareMobilePaymentsSDK (2.5.0)
   - Yoga (0.0.0)
 
 DEPENDENCIES:
@@ -1823,8 +1823,8 @@ SPEC CHECKSUMS:
   fmt: 4c2741a687cc09f0634a2e2c72a838b99f1ff120
   glog: 69ef571f3de08433d766d614c73a9838a06bf7eb
   hermes-engine: 8d2103d6c0176779aea4e25df6bb1410f9946680
-  mobile-payments-sdk-react-native: 161fbdf5a7a5cd788224a78d361c08c5d2a3fb8c
-  MockReaderUI: e527a5bc446b95e8cd5ddb4c565fc7d614d38a0f
+  mobile-payments-sdk-react-native: b32d25a22d460063b2c705d86740998613d10e3e
+  MockReaderUI: 651252bf60bffc2699866448a6fb7250c06be785
   Permission-BluetoothPeripheral: 34ab829f159c6cf400c57bac05f5ba1b0af7a86e
   Permission-LocationAccuracy: 30c5421911024b28d8916db5cbd728097da54434
   Permission-LocationAlways: af165dee8a5a5888df6764f9f6ba98b112893709
@@ -1891,7 +1891,7 @@ SPEC CHECKSUMS:
   RNScreens: 35bb8e81aeccf111baa0ea01a54231390dbbcfd9
   RNVectorIcons: 182892e7d1a2f27b52d3c627eca5d2665a22ee28
   SocketRocket: abac6f5de4d4d62d24e11868d7a2f427e0ef940d
-  SquareMobilePaymentsSDK: 53cd315a537037377cd364edc874bf75782239eb
+  SquareMobilePaymentsSDK: 61d783cb2ef4b238731f4433a42028d95c77893c
   Yoga: 4ef80d96a5534f0e01b3055f17d1e19a9fc61b63
 
 PODFILE CHECKSUM: 81d2f9e3393262e2bc7a99478a8e3a6741f0482e

diff --git a/ios/Podfile b/ios/Podfile
@@ -7,7 +7,7 @@ target 'RNMobilePaymentSDK' do
   use_frameworks!
 
   # Pods for RNMobilePaymentSDK
-  pod "SquareMobilePaymentsSDK", "~> 2.4.0"
+  pod "SquareMobilePaymentsSDK", "~> 2.5.0"
   target 'RNMobilePaymentSDKTests' do
     inherit! :search_paths
     # Pods for testing

diff --git a/ios/Podfile.lock b/ios/Podfile.lock
@@ -1,16 +1,16 @@
 PODS:
-  - SquareMobilePaymentsSDK (2.4.0)
+  - SquareMobilePaymentsSDK (2.5.0)
 
 DEPENDENCIES:
-  - SquareMobilePaymentsSDK (~> 2.4.0)
+  - SquareMobilePaymentsSDK (~> 2.5.0)
 
 SPEC REPOS:
   trunk:
     - SquareMobilePaymentsSDK
 
 SPEC CHECKSUMS:
-  SquareMobilePaymentsSDK: 53cd315a537037377cd364edc874bf75782239eb
+  SquareMobilePaymentsSDK: 61d783cb2ef4b238731f4433a42028d95c77893c
 
-PODFILE CHECKSUM: 90edd7b3e424a600173ffd8b1fcb677878cc582e
+PODFILE CHECKSUM: b2206f603fba9bc930b94625386c4dfad56fed65
 
 COCOAPODS: 1.16.2
diff --git a/mobile-payments-sdk-react-native.podspec b/mobile-payments-sdk-react-native.podspec
@@ -14,8 +14,8 @@ Pod::Spec.new do |s|
   s.platforms    = { :ios => "16" }
   s.source       = { :git => "https://github.com/square//mobile-payments-sdk-react-native.git", :tag => "#{s.version}" }
 
-  s.dependency "MockReaderUI", "~> 2.4.0"
-  s.dependency "SquareMobilePaymentsSDK", "~> 2.4.0"
+  s.dependency "MockReaderUI", "~> 2.5.0"
+  s.dependency "SquareMobilePaymentsSDK", "~> 2.5.0"
 
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mobile-payments-sdk-react-native",
-  "version": "2026.3.4",
+  "version": "2026.4.1",
   "description": "Mobile Payments SDK plug-in for React Native. Enables developers to build secure in-person payment solutions.",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",

diff --git a/src/models/objects.ts b/src/models/objects.ts
@@ -182,8 +182,6 @@ export type ReaderInfo = {
   serialNumber?: String;
   name: String;
   batteryStatus?: ReaderBatteryStatus;
-  firmwareVersion?: String;
-  firmwarePercent?: Number;
   supportedCardEntryMethods: CardEntryMethod[];
   isForgettable: Boolean;
   isBlinkable: Boolean;