@connexup/react-native-square-mobile-payment-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Connexup
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NativeSquareMobilePaymentSDK.podspec

@@ -0,0 +1,23 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "NativeSquareMobilePaymentSDK"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => [min_ios_version_supported, "16.0"].max }
+  s.source       = { :git => package["repository"]["url"], :tag => "#{s.version}" }
+
+  s.dependency "MockReaderUI", "~> 2.3.1"
+  s.dependency "SquareMobilePaymentsSDK", "~> 2.3.1"
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,66 @@
+# react-native-square-mobile-payment-sdk
+
+Mobile Payments SDK for React Native
+
+* [iOS](https://developer.squareup.com/docs/mobile-payments-sdk/ios#1-install-the-sdk-and-dependencies)
+* [Android](https://developer.squareup.com/docs/mobile-payments-sdk/android#1-install-the-sdk-and-dependencies)
+
+## 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)
+
+## Installation
+```sh
+yarn add react-native-square-mobile-payment-sdk
+```
+
+## Before you start
+* You will need a Square account enabled for payment processing. If you have not enabled payment processing on your account (or you are not sure), visit [squareup.com/activate](https://squareup.com/activate).
+* Set-up your React Native environment by following the [official guide](https://reactnative.dev/docs/set-up-your-environment).
+
+  For iOS:
+1. Make sure you run `pod install` in the `ios` folder of the sample application to install the SDK and all the dependencies.
+2. On your application targets’ `Build Phases` settings tab, click the + icon and choose `New Run Script Phase`. Create a Run Script in which you specify your shell (ex: /bin/sh), and add the following contents to the script area below the shell:
+```
+SETUP_SCRIPT=${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}"/SquareMobilePaymentsSDK.framework/setup"
+if [ -f "$SETUP_SCRIPT" ]; then
+  "$SETUP_SCRIPT"
+fi
+```
+
+Make sure this build phase is after any `[CP] Embed Pods Frameworks` or `Embed Frameworks` Build Phase.
+
+For Android:
+1. Modify your `/android/build.gradle`
+   Add `maven { url 'https://sdk.squareup.com/public/android/' }` inside the `allprojects`'s `repositories {...}` block
+2. Disable Proguard by adding the following to your `/android/app/build.gradle`:
+```gradle
+android {
+    buildTypes {
+        release {
+            minifyEnabled false
+            shrinkResources false
+        }
+    }
+}
+```
+
+## Documentation
+* [Mobile Payments SDK Overview](https://developer.squareup.com/docs/mobile-payments-sdk)
+* [iOS Tech Reference](https://developer.squareup.com/docs/sdk/mobile-payments/ios)
+* [Android Tech Reference](https://developer.squareup.com/docs/sdk/mobile-payments/android)
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,81 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['NativeSquareMobilePaymentSDK_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["NativeSquareMobilePaymentSDK_" + name]).toInteger()
+}
+
+android {
+  namespace "com.connexup.square.mobilepayment"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation 'com.google.code.gson:gson:2.8.5'
+  def squareSdkVersion = "2.3.4"
+  implementation "com.squareup.sdk:mobile-payments-sdk:$squareSdkVersion"
+  implementation "com.squareup.sdk:mockreader-ui:$squareSdkVersion"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+NativeSquareMobilePaymentSDK_kotlinVersion=2.0.21
+NativeSquareMobilePaymentSDK_minSdkVersion=28
+NativeSquareMobilePaymentSDK_targetSdkVersion=35
+NativeSquareMobilePaymentSDK_compileSdkVersion=35
+NativeSquareMobilePaymentSDK_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/connexup/square/mobilepayment/DateFormatUtils.java

@@ -0,0 +1,29 @@
+package com.connexup.square.mobilepayment;
+
+/**
+ * Description:
+ *
+ * @author lukechen@chancetop.com
+ * @date 2023/11/20
+ */
+
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+
+public class DateFormatUtils {
+
+    private static final ThreadLocal<DateFormat> ISO_8601 = new ThreadLocal<DateFormat>() {
+        @Override
+        protected DateFormat initialValue() {
+            return new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssZ");
+        }
+    };
+
+    public static String formatISO8601UTC(Date date) {
+        if (date == null) {
+            return null;
+        }
+        return ISO_8601.get().format(date);
+    }
+}

package/android/src/main/java/com/connexup/square/mobilepayment/ErrorUtilities.kt

@@ -0,0 +1,56 @@
+package com.connexup.square.mobilepayment
+
+import com.google.gson.GsonBuilder
+
+/**
+ * Description:
+ * @author lukechen@chancetop.com
+ * @date 2023/11/16
+ */
+
+private const val JSON_PLACE_HOLDER = "{'message': 'failed to serialize error'}"
+
+const val UNKNOWN_ERROR = "UNKNOWN_ERROR"
+const val PARAMS_ERROR = "PARAMS_ERROR"
+
+object RNMobilePaymentErrorUtilities {
+
+    private val gson by lazy {
+        GsonBuilder().create()
+    }
+
+    fun createNativeModuleError(
+        code: String?,
+        message: String = String.format(
+            "Something went wrong. Please contact the developer of this application and provide them with this error code: %s",
+            code
+        ),
+        debugCode: String? = null,
+        debugMessage: String? = null
+    ): String? {
+        return serializeErrorToJson(
+            code,
+            message,
+            debugCode,
+            debugMessage,
+        )
+    }
+
+    fun serializeErrorToJson(
+        code: String?,
+        message: String?,
+        debugCode: String? = null,
+        debugMessage: String? = null
+    ): String? {
+        val errorMap = hashMapOf<String, String?>()
+        errorMap["code"] = code
+        errorMap["message"] = message
+        errorMap["debugCode"] = debugCode
+        errorMap["debugMessage"] = debugMessage
+        return try {
+            gson.toJson(errorMap) ?: JSON_PLACE_HOLDER
+        } catch (e: MobilePaymentException) {
+            JSON_PLACE_HOLDER
+        }
+    }
+}

package/android/src/main/java/com/connexup/square/mobilepayment/MobilePaymentAuthorization.kt

@@ -0,0 +1,185 @@
+package com.connexup.square.mobilepayment
+
+import com.connexup.square.mobilepayment.convert.jsonValue
+import com.connexup.square.mobilepayment.convert.writableMap
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.WritableMap
+import com.squareup.sdk.mobilepayments.MobilePaymentsSdk
+import com.squareup.sdk.mobilepayments.authorization.AuthorizationState
+import com.squareup.sdk.mobilepayments.authorization.AuthorizeErrorCode
+import com.squareup.sdk.mobilepayments.core.CallbackReference
+import com.squareup.sdk.mobilepayments.core.Result
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.launch
+
+/**
+ * Description:
+ * @author lukechen@chancetop.com
+ * @date 2026/1/30
+ */
+
+private const val AUTHORIZATION_ERROR_NO_NETWORK = "AUTHORIZATION_ERROR_NO_NETWORK"
+private const val AUTHORIZATION_ERROR_ALREADY_AUTHORIZED = "AUTHORIZATION_ERROR_ALREADY_AUTHORIZED"
+private const val AUTHORIZATION_ERROR_ALREADY_IN_PROGRESS =
+  "AUTHORIZATION_ERROR_ALREADY_IN_PROGRESS"
+private const val AUTHORIZATION_ERROR_DEAUTHORIZATION_IN_PROGRESS =
+  "AUTHORIZATION_ERROR_DEAUTHORIZATION_IN_PROGRESS"
+private const val AUTHORIZATION_ERROR_AUTHORIZATION_CODE_ALREADY_REDEEMED =
+  "AUTHORIZATION_ERROR_AUTHORIZATION_CODE_ALREADY_REDEEMED"
+private const val AUTHORIZATION_ERROR_EXPIRED_AUTHORIZATION_CODE =
+  "AUTHORIZATION_ERROR_EXPIRED_AUTHORIZATION_CODE"
+private const val AUTHORIZATION_ERROR_INVALID_AUTHORIZATION_CODE =
+  "AUTHORIZATION_ERROR_INVALID_AUTHORIZATION_CODE"
+private const val AUTHORIZATION_ERROR_INVALID_ACCESS_TOKEN =
+  "AUTHORIZATION_ERROR_INVALID_ACCESS_TOKEN"
+private const val AUTHORIZATION_ERROR_EMPTY_ACCESS_TOKEN = "AUTHORIZATION_ERROR_EMPTY_ACCESS_TOKEN"
+private const val AUTHORIZATION_ERROR_INVALID_LOCATION_ID =
+  "AUTHORIZATION_ERROR_INVALID_LOCATION_ID"
+private const val AUTHORIZATION_ERROR_LOCATION_NOT_ACTIVATED_FOR_CARD_PROCESSING =
+  "AUTHORIZATION_ERROR_LOCATION_NOT_ACTIVATED_FOR_CARD_PROCESSING"
+private const val AUTHORIZATION_ERROR_EMPTY_LOCATION_ID = "AUTHORIZATION_ERROR_EMPTY_LOCATION_ID"
+private const val AUTHORIZATION_ERROR_UNSUPPORTED_COUNTRY =
+  "AUTHORIZATION_ERROR_UNSUPPORTED_COUNTRY"
+private const val AUTHORIZATION_ERROR_UNEXPECTED = "AUTHORIZATION_ERROR_UNEXPECTED"
+
+class MobilePaymentAuthorization(reactContext: ReactApplicationContext) :
+  NativeMobilePaymentAuthorizationSpec(reactContext) {
+
+  private val scope: CoroutineScope by lazy {
+    CoroutineScope(
+      SupervisorJob() + Dispatchers.Main
+    )
+  }
+
+  @Volatile
+  private var authorizationStateChangedCallbackRef: CallbackReference? = null
+
+  private var authorizeCallbackRef: CallbackReference? = null
+  private var deauthorizeCallbackRef: CallbackReference? = null
+
+  @Volatile
+  private var deauthorizePromise: Promise? = null
+
+  private var initializeListener: InitializeListener? = null
+
+  override fun initialize() {
+    super.initialize()
+    this.initializeListener = MobilePaymentSDK.addInitializeListener {
+      onSDKInitialize()
+    }
+    if (MobilePaymentSDK.isInitialize) {
+      initializeListener?.onInitialize()
+    }
+  }
+
+  override fun invalidate() {
+    initializeListener?.let {
+      MobilePaymentSDK.removeInitializeListener(it)
+    }
+    initializeListener = null
+    authorizationStateChangedCallbackRef?.clear()
+    authorizationStateChangedCallbackRef = null
+    authorizeCallbackRef?.clear()
+    authorizeCallbackRef = null
+    deauthorizeCallbackRef?.clear()
+    deauthorizeCallbackRef = null
+    super.invalidate()
+  }
+
+  private fun onSDKInitialize() {
+    authorizationStateChangedCallbackRef?.clear()
+    authorizationStateChangedCallbackRef =
+      MobilePaymentsSdk.authorizationManager().setAuthorizationStateChangedCallback {
+        if (deauthorizePromise != null && it == AuthorizationState.newUnauthorizedState()) {
+          deauthorizePromise?.resolve(null)
+          deauthorizePromise = null
+        }
+        emitOnAuthorizationStateChange(it.jsonValue)
+      }
+  }
+
+  override fun authorize(
+    accessToken: String,
+    locationID: String,
+    promise: Promise
+  ) {
+    scope.launch {
+      if (authorizeCallbackRef != null) {
+        promise.reject(
+          AUTHORIZATION_ERROR_ALREADY_IN_PROGRESS,
+          RNMobilePaymentErrorUtilities.createNativeModuleError(
+            AUTHORIZATION_ERROR_ALREADY_IN_PROGRESS,
+          ),
+          null
+        )
+        return@launch
+      }
+      authorizeCallbackRef =
+        MobilePaymentsSdk.authorizationManager().authorize(accessToken, locationID) {
+          authorizeCallbackRef?.clear()
+          authorizeCallbackRef = null
+
+          when (it) {
+            is Result.Failure -> {
+              val errorCode = when (it.errorCode) {
+                AuthorizeErrorCode.NO_NETWORK -> AUTHORIZATION_ERROR_NO_NETWORK
+                AuthorizeErrorCode.USAGE_ERROR -> AUTHORIZATION_ERROR_UNEXPECTED
+                AuthorizeErrorCode.UNSUPPORTED_COUNTRY -> AUTHORIZATION_ERROR_UNSUPPORTED_COUNTRY
+              }
+              promise.reject(
+                errorCode,
+                RNMobilePaymentErrorUtilities.serializeErrorToJson(
+                  code = errorCode,
+                  message = it.errorMessage,
+                  debugCode = it.debugCode,
+                  debugMessage = it.debugMessage
+                ),
+                MobilePaymentException(it.errorMessage),
+              )
+            }
+
+            is Result.Success -> {
+              promise.resolve(null)
+            }
+          }
+        }
+    }
+  }
+
+  override fun deauthorize(promise: Promise) {
+    scope.launch {
+      if (MobilePaymentsSdk.authorizationManager().authorizationState == AuthorizationState.newUnauthorizedState()) {
+        promise.resolve(null)
+        return@launch
+      }
+      //TODO improve
+      if (MobilePaymentsSdk.authorizationManager().authorizationState == AuthorizationState.newInProgressState()) {
+        promise.reject(
+          AUTHORIZATION_ERROR_DEAUTHORIZATION_IN_PROGRESS,
+          RNMobilePaymentErrorUtilities.createNativeModuleError(
+            AUTHORIZATION_ERROR_DEAUTHORIZATION_IN_PROGRESS,
+          ),
+          null
+        )
+        return@launch
+      }
+      deauthorizePromise = promise
+      MobilePaymentsSdk.authorizationManager().deauthorize()
+    }
+  }
+
+  override fun state(): String {
+    return MobilePaymentsSdk.authorizationManager().authorizationState.jsonValue
+  }
+
+  override fun location(): WritableMap? {
+    return MobilePaymentsSdk.authorizationManager().location?.writableMap
+  }
+
+  companion object {
+    const val NAME = NativeMobilePaymentAuthorizationSpec.NAME
+  }
+}

package/android/src/main/java/com/connexup/square/mobilepayment/MobilePaymentException.kt

@@ -0,0 +1,8 @@
+package com.connexup.square.mobilepayment
+
+/**
+ * Description:
+ * @author lukechen@chancetop.com
+ * @date 2023/11/16
+ */
+class MobilePaymentException(message: String?) : Exception(message)