square · cesar-sosa-hol · Jul 30, 2026 · Jul 29, 2026 · Jul 29, 2026 · Jul 30, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,14 @@
 ## Changelog
 
+### v2026.7.1 Jul 28, 2026
+
+* Upgrade Android and iOS native SDK to `2.6.0`
+* Add `HOST_ID_MISMATCH` to `ReaderUnavailableReason` and `ReaderPairingError` (Android only). It is reported when a reader refuses a connection because another device is its most-recently-paired host, and was previously surfaced as a generic `INTERNAL_ERROR` / unknown error. Prompt the user to put the reader into pairing mode to re-pair it with the current device
+* Cash payments may now be automatically rounded to the nearest five cents for CAD and AUD, and optionally USD when enabled for the seller. Payment results reflect the rounded amount
+* **iOS:** Fixes an issue where calling `authorize` during SDK startup could leave connected readers in an indeterminate state that required reconnecting to become `READY`. Adds support for iOS 27
+* **Breaking (Android):** Requires `compileSdkVersion` 36 or higher and Android Gradle Plugin `8.9.1` or higher (Gradle `8.13` or higher). Native SDK `2.6.0` pulls in `androidx.core:core:1.18.0`, which enforces these minimums. The example app now uses AGP `8.11.1` and Gradle `8.14`
+* **Breaking (Android):** The native `ExternalPaymentDetails`, `ExternalTenderType` and `Payment.externalDetails` APIs were removed in native SDK `2.6.0`. `SourceType.EXTERNAL` remains available
+
 ### v2026.4.1 Apr 22, 2026
 
 * Upgrade Android and iOS native SDK to `2.5.0`

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -43,8 +43,8 @@ The SDK follows a standard React Native bridge pattern with four feature manager
 
 ## Platform Constraints
 
-- **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`).
+- **iOS**: Min deployment target 16. Depends on `SquareMobilePaymentsSDK ~> 2.6.0` and `MockReaderUI ~> 2.6.0`.
+- **Android**: Min SDK 28, Compile/Target SDK 36 (required by `androidx.core:core:1.18.0`, pulled in by native SDK 2.6.0). AGP 8.9.1+ / Gradle 8.13+. 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).
 - Supports both old (bridge) and new (TurboModule) React Native architectures.

diff --git a/README.md b/README.md
@@ -4,17 +4,26 @@
 
 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.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
+  * [iOS](https://developer.squareup.com/docs/mobile-payments-sdk/ios#1-install-the-sdk-and-dependencies): 2.6.0 and above
+  * [Android](https://developer.squareup.com/docs/mobile-payments-sdk/android#1-install-the-sdk-and-dependencies): 2.6.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:
 * Android: [Requirements and Limitations](https://developer.squareup.com/docs/mobile-payments-sdk/android#requirements-and-limitations), [Device Compatibility](https://developer.squareup.com/docs/mobile-payments-sdk/android#device-permissions)
 * iOS: [Requirements and Limitations](https://developer.squareup.com/docs/mobile-payments-sdk/ios#requirements-and-limitations), [Device Compatibility](https://developer.squareup.com/docs/mobile-payments-sdk/ios#device-permissions)
 
+## Android build requirements
+
+Mobile Payments SDK 2.6.0 depends on `androidx.core:core:1.18.0`, which requires your Android app to be built with:
+
+* `compileSdkVersion` 36 or higher
+* Android Gradle Plugin 8.9.1 or higher (Gradle 8.13 or higher)
+
+Builds using older values fail during dependency resolution.
+
 ## Android: Kotlin 2.2.x Compatibility
 
-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.
+Mobile Payments SDK 2.6.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
@@ -8,7 +8,7 @@ buildscript {
   }
 
   dependencies {
-    classpath "com.android.tools.build:gradle:8.7.2"
+    classpath "com.android.tools.build:gradle:8.11.1"
     // noinspection DifferentKotlinGradleVersion
     classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
   }
@@ -88,7 +88,7 @@ repositories {
 }
 
 def kotlin_version = getExtOrDefault("kotlinVersion")
-def squareSdkVersion = "2.5.0"
+def squareSdkVersion = "2.6.0"
 
 dependencies {
   // For < 0.71, this will be from the local maven repo

diff --git a/android/gradle.properties b/android/gradle.properties
@@ -1,5 +1,5 @@
 MobilePaymentsSdkReactNative_kotlinVersion=2.2.21
 MobilePaymentsSdkReactNative_minSdkVersion=28
-MobilePaymentsSdkReactNative_targetSdkVersion=35
-MobilePaymentsSdkReactNative_compileSdkVersion=35
+MobilePaymentsSdkReactNative_targetSdkVersion=36
+MobilePaymentsSdkReactNative_compileSdkVersion=36
 MobilePaymentsSdkReactNative_ndkversion=26.1.10909125
diff --git a/android/gradle/wrapper/gradle-wrapper.properties b/android/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-bin.zip
 networkTimeout=60000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

diff --git a/android/src/main/java/com/mobilepaymentssdkreactnative/Utils.kt b/android/src/main/java/com/mobilepaymentssdkreactnative/Utils.kt
@@ -205,7 +205,6 @@ fun Payment.toPaymentMap(): ReadableMap {
     putMap("totalMoney", totalMoney.toMoneyMap())
     putString("updatedAt", updatedAt.toIsoInstantString())
     //cashDetails
-    //externalDetails
     when (this@toPaymentMap) {
       is OfflinePayment -> {
         putString("uploadedAt", uploadedAt?.toIsoInstantString())
@@ -438,6 +437,7 @@ fun ReaderInfo.Status.toUnavailableReasonString(): String? {
         ReaderInfo.Status.ReaderUnavailable.ReaderUnavailableReason.DEVICE_ROOTED -> "DEVICE_ROOTED"
         ReaderInfo.Status.ReaderUnavailable.ReaderUnavailableReason.DEVICE_DEVELOPER_MODE -> "DEVICE_DEVELOPER_MODE"
         ReaderInfo.Status.ReaderUnavailable.ReaderUnavailableReason.DISABLED -> "DISABLED"
+        ReaderInfo.Status.ReaderUnavailable.ReaderUnavailableReason.HOST_ID_MISMATCH -> "HOST_ID_MISMATCH"
       }
   }
   return  null;

diff --git a/docs/KOTLIN_COMPATIBILITY.md b/docs/KOTLIN_COMPATIBILITY.md
@@ -1,8 +1,10 @@
 # Kotlin 2.2.x Compatibility Workaround for React Native
 
-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.
+Mobile Payments SDK 2.6.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.5.0 with React Native until React Native itself adds support for Kotlin 2.2.x.
+Mobile Payments SDK 2.6.0 also requires **Android Gradle Plugin 8.9.1 or higher** (and therefore Gradle 8.13 or higher), because it depends on `androidx.core:core:1.18.0`. React Native's Gradle plugin compiles itself with `allWarningsAsErrors = true`, and those Gradle versions emit new deprecation warnings, so its own compilation fails too.
+
+This guide explains how to apply a patch to your project so you can use Mobile Payments SDK 2.6.0 with React Native until React Native itself adds support for Kotlin 2.2.x and recent Gradle versions.
 
 > **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.
 
@@ -16,6 +18,14 @@ Unresolved reference: KotlinTopLevelExtension
 
 This happens because React Native's Gradle plugin (`@react-native/gradle-plugin`) references `org.jetbrains.kotlin.gradle.dsl.KotlinTopLevelExtension`, which was removed in Kotlin 2.2.x and replaced with `kotlinExtension`.
 
+With Gradle 8.13 or higher you will also see:
+
+```
+e: warnings found and -Werror specified
+```
+
+React Native's Gradle plugin treats its own compilation warnings as errors, and recent Gradle versions deprecate APIs it still uses (for example `Project.exec`).
+
 ## Fix: Apply a Patch with `patch-package`
 
 ### 1. Install `patch-package`
@@ -63,6 +73,19 @@ mkdir -p patches
 Paste the following contents into `patches/@react-native+gradle-plugin+0.75.3.patch`:
 
 ```diff
+diff --git a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/build.gradle.kts b/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/build.gradle.kts
+index d8bcfed..c376cd7 100644
+--- a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/build.gradle.kts
++++ b/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/build.gradle.kts
+@@ -65,7 +65,7 @@ tasks.withType<KotlinCompile>().configureEach {
+     apiVersion = "1.6"
+     // See comment above on JDK 11 support
+     jvmTarget = "11"
+-    allWarningsAsErrors = true
++    allWarningsAsErrors = false
+   }
+ }
+
 diff --git a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/src/main/kotlin/com/facebook/react/utils/JdkConfiguratorUtils.kt b/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/src/main/kotlin/com/facebook/react/utils/JdkConfiguratorUtils.kt
 index 0d55714..e59e9d5 100644
 --- a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/src/main/kotlin/com/facebook/react/utils/JdkConfiguratorUtils.kt
@@ -111,7 +134,7 @@ Applying patches...
 
 ### 5. Build your project
 
-Your Android build should now succeed with Kotlin 2.2.21 and Mobile Payments SDK 2.5.0.
+Your Android build should now succeed with Kotlin 2.2.21 and Mobile Payments SDK 2.6.0.
 
 ## Removing the Workaround
 

diff --git a/docs/README.md b/docs/README.md
@@ -41,7 +41,8 @@ Make sure this build phase is after any `[CP] Embed Pods Frameworks` or `Embed F
 
 For Android:
 1. Modify your `/android/build.gradle`
-   - Add `squareSdkVersion = "2.0.2"` inside the `ext {...}` block
+   - Add `squareSdkVersion = "2.6.0"` inside the `ext {...}` block
+   - Set `compileSdkVersion = 36` (or higher) and use Android Gradle Plugin `8.9.1` or higher with Gradle `8.13` or higher, as required by `androidx.core:core:1.18.0`
    - Add `maven { url 'https://sdk.squareup.com/public/android/' }` inside the `allprojects`'s `repositories {...}` block
 2. Modify your `/android/app/build.gradle`
    - Add `implementation("com.squareup.sdk:mobile-payments-sdk:$squareSdkVersion")` inside the `dependencies{...}` block

diff --git a/example-expo/app.plugin.js b/example-expo/app.plugin.js
@@ -36,8 +36,8 @@ const withSquareMavenRepository = (config) => {
       const mavenUrl =
         'maven { url("https://sdk.squareup.com/public/android/") }';
       // Expo 54 KSP only maps Kotlin up to 2.2.20 (not 2.2.21 used by the RN
-      // library), and Square Mobile Payments SDK 2.5.0 transitively pulls
-      // kotlin-stdlib 2.3.x. We cannot align all Kotlin versions in this sample
+      // library), and Square Mobile Payments SDK 2.6.0 is compiled with Kotlin
+      // 2.3.x metadata. We cannot align all Kotlin versions in this sample
       // until Expo bumps its KSP/Kotlin support. This flag is required so the
       // app compiles against the mixed metadata; remove once Expo supports the
       // Kotlin version required by the Square SDK without a metadata mismatch.

diff --git a/example/android/build.gradle b/example/android/build.gradle
@@ -1,9 +1,9 @@
 buildscript {
     ext {
-        buildToolsVersion = "34.0.0"
+        buildToolsVersion = "36.0.0"
         minSdkVersion = 28
-        compileSdkVersion = 35
-        targetSdkVersion = 35
+        compileSdkVersion = 36
+        targetSdkVersion = 36
         ndkVersion = "26.1.10909125"
         kotlinVersion = "2.2.21"
     }
@@ -12,7 +12,7 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath("com.android.tools.build:gradle:8.7.2")
+        classpath("com.android.tools.build:gradle:8.11.1")
         classpath("com.facebook.react:react-native-gradle-plugin")
         classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion")
     }

diff --git a/example/android/gradle/wrapper/gradle-wrapper.properties b/example/android/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-all.zip
 networkTimeout=60000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

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.4.1):
+  - mobile-payments-sdk-react-native (2026.7.1):
     - DoubleConversion
     - glog
     - hermes-engine
-    - MockReaderUI (~> 2.5.0)
+    - MockReaderUI (~> 2.6.0)
     - RCT-Folly (= 2024.01.01.00)
     - RCTRequired
     - RCTTypeSafety
@@ -28,9 +28,9 @@ PODS:
     - ReactCodegen
     - ReactCommon/turbomodule/bridging
     - ReactCommon/turbomodule/core
-    - SquareMobilePaymentsSDK (~> 2.5.0)
+    - SquareMobilePaymentsSDK (~> 2.6.0)
     - Yoga
-  - MockReaderUI (2.5.0)
+  - MockReaderUI (2.6.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.5.0)
+  - SquareMobilePaymentsSDK (2.6.0)
   - Yoga (0.0.0)
 
 DEPENDENCIES:
@@ -1823,8 +1823,8 @@ SPEC CHECKSUMS:
   fmt: 4c2741a687cc09f0634a2e2c72a838b99f1ff120
   glog: 69ef571f3de08433d766d614c73a9838a06bf7eb
   hermes-engine: 8d2103d6c0176779aea4e25df6bb1410f9946680
-  mobile-payments-sdk-react-native: 648e9e228798472f028ed9fd02ae172581ac1692
-  MockReaderUI: 651252bf60bffc2699866448a6fb7250c06be785
+  mobile-payments-sdk-react-native: 5043e9739abac95242a248e3fa6764020767cb56
+  MockReaderUI: f920dd06eaa41846b5c033da4bc01993b5ad4e50
   Permission-BluetoothPeripheral: 34ab829f159c6cf400c57bac05f5ba1b0af7a86e
   Permission-LocationAccuracy: 30c5421911024b28d8916db5cbd728097da54434
   Permission-LocationAlways: af165dee8a5a5888df6764f9f6ba98b112893709
@@ -1891,7 +1891,7 @@ SPEC CHECKSUMS:
   RNScreens: 35bb8e81aeccf111baa0ea01a54231390dbbcfd9
   RNVectorIcons: 182892e7d1a2f27b52d3c627eca5d2665a22ee28
   SocketRocket: abac6f5de4d4d62d24e11868d7a2f427e0ef940d
-  SquareMobilePaymentsSDK: 61d783cb2ef4b238731f4433a42028d95c77893c
+  SquareMobilePaymentsSDK: 7fd3fd8f9c3b114d5a0e747bc52120a6edd87c4b
   Yoga: 4ef80d96a5534f0e01b3055f17d1e19a9fc61b63
 
 PODFILE CHECKSUM: 81d2f9e3393262e2bc7a99478a8e3a6741f0482e

diff --git a/example/patches/@react-native+gradle-plugin+0.75.3.patch b/example/patches/@react-native+gradle-plugin+0.75.3.patch
@@ -1,3 +1,16 @@
+diff --git a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/build.gradle.kts b/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/build.gradle.kts
+index d8bcfed..c376cd7 100644
+--- a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/build.gradle.kts
++++ b/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/build.gradle.kts
+@@ -65,7 +65,7 @@ tasks.withType<KotlinCompile>().configureEach {
+     apiVersion = "1.6"
+     // See comment above on JDK 11 support
+     jvmTarget = "11"
+-    allWarningsAsErrors = true
++    allWarningsAsErrors = false
+   }
+ }
+
 diff --git a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/src/main/kotlin/com/facebook/react/utils/JdkConfiguratorUtils.kt b/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/src/main/kotlin/com/facebook/react/utils/JdkConfiguratorUtils.kt
 index 0d55714..e59e9d5 100644
 --- a/node_modules/@react-native/gradle-plugin/react-native-gradle-plugin/src/main/kotlin/com/facebook/react/utils/JdkConfiguratorUtils.kt

diff --git a/ios/Podfile b/ios/Podfile
@@ -7,7 +7,7 @@ target 'RNMobilePaymentSDK' do
   use_frameworks!
 
   # Pods for RNMobilePaymentSDK
-  pod "SquareMobilePaymentsSDK", "~> 2.5.0"
+  pod "SquareMobilePaymentsSDK", "~> 2.6.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.5.0)
+  - SquareMobilePaymentsSDK (2.6.0)
 
 DEPENDENCIES:
-  - SquareMobilePaymentsSDK (~> 2.5.0)
+  - SquareMobilePaymentsSDK (~> 2.6.0)
 
 SPEC REPOS:
   trunk:
     - SquareMobilePaymentsSDK
 
 SPEC CHECKSUMS:
-  SquareMobilePaymentsSDK: 61d783cb2ef4b238731f4433a42028d95c77893c
+  SquareMobilePaymentsSDK: 7fd3fd8f9c3b114d5a0e747bc52120a6edd87c4b
 
-PODFILE CHECKSUM: b2206f603fba9bc930b94625386c4dfad56fed65
+PODFILE CHECKSUM: 9fbaec2432e5c2b560244e342d7926484c63cfac
 
 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.5.0"
-  s.dependency "SquareMobilePaymentsSDK", "~> 2.5.0"
+  s.dependency "MockReaderUI", "~> 2.6.0"
+  s.dependency "SquareMobilePaymentsSDK", "~> 2.6.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.4.1",
+  "version": "2026.7.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/enums.ts b/src/models/enums.ts
@@ -222,6 +222,7 @@ export enum ReaderUnavailableReason {
   DEVICE_ROOTED = 'DEVICE_ROOTED',
   DEVICE_DEVELOPER_MODE = 'DEVICE_DEVELOPER_MODE',
   DISABLED = 'DISABLED',
+  HOST_ID_MISMATCH = 'HOST_ID_MISMATCH',
   MAX_READERS_CONNECTED = 'MAX_READERS_CONNECTED',
   NOT_CONNECTED_TO_INTERNET = 'NOT_CONNECTED_TO_INTERNET',
   READER_TIMEOUT = 'READER_TIMEOUT',

diff --git a/src/models/errors.ts b/src/models/errors.ts
@@ -64,6 +64,7 @@ export enum ReaderPairingError {
   READER_ALREADY_PAIRING,
   TIMED_OUT,
   UPDATE_REQUIRED,
+  HOST_ID_MISMATCH,
 }
 
 // Corresponds to the ErrorDetails inside the Failure object in the SDK