@capacitor-community/stripe-terminal 8.0.1 → 8.1.0

package/CapacitorCommunityStripeTerminal.podspec

@@ -13,6 +13,6 @@ Pod::Spec.new do |s|
   s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
   s.ios.deployment_target = '15.0'
   s.dependency 'Capacitor'
-  s.dependency 'StripeTerminal', '~> 4.7'
+  s.dependency 'StripeTerminal', '~> 5.3.0'
   s.swift_version = '5.1'
 end

package/Package.swift

@@ -11,7 +11,7 @@ let package = Package(
     ],
     dependencies: [
         .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0"),
-        .package(url: "https://github.com/stripe/stripe-terminal-ios.git", .upToNextMinor(from: "4.7.0"))
+        .package(url: "https://github.com/stripe/stripe-terminal-ios.git", .upToNextMinor(from: "5.3.0"))
     ],
     targets: [
         .target(

package/README.md

@@ -222,6 +222,7 @@ await StripeTerminal.setSimulatorConfiguration({ update: SimulateReaderUpdate.Up
 * [`clearReaderDisplay()`](#clearreaderdisplay)
 * [`rebootReader()`](#rebootreader)
 * [`cancelReaderReconnection()`](#cancelreaderreconnection)
+* [`setTapToPayUxConfiguration(...)`](#settaptopayuxconfiguration)
 * [`addListener(TerminalEventsEnum.Loaded, ...)`](#addlistenerterminaleventsenumloaded-)
 * [`addListener(TerminalEventsEnum.RequestedConnectionToken, ...)`](#addlistenerterminaleventsenumrequestedconnectiontoken-)
 * [`addListener(TerminalEventsEnum.DiscoveredReaders, ...)`](#addlistenerterminaleventsenumdiscoveredreaders-)
@@ -441,6 +442,23 @@ cancelReaderReconnection() => Promise<void>
 --------------------
 
 
+### setTapToPayUxConfiguration(...)
+
+```typescript
+setTapToPayUxConfiguration(options: TapToPayUxConfiguration) => Promise<void>
+```
+
+Configure the Tap to Pay UX appearance (Android only).
+Call this after initialize() but before connectReader().
+Has no effect on iOS or web platforms.
+
+| Param         | Type                                                                        |
+| ------------- | --------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#taptopayuxconfiguration">TapToPayUxConfiguration</a></code> |
+
+--------------------
+
+
 ### addListener(TerminalEventsEnum.Loaded, ...)
 
 ```typescript
@@ -922,6 +940,28 @@ addListener(eventName: TerminalEventsEnum.ReaderReconnectFailed, listenerFunc: (
 | **`bluetoothScanWaitTime`** | <code>number</code>                                                   | Only applies to Bluetooth scan discovery (iOS only). During discovery, readers are reported via DiscoveryDelegate.didUpdateDiscoveredReaders. This timeout controls how long to wait before resolving the `discoverReaders` method with the current list. If this setting is not specified or is set to 0, the initial scan results will be returned. |
 
 
+#### TapToPayUxConfiguration
+
+Configuration for the Tap to Pay UX (Android only).
+
+| Prop           | Type                                                                | Description                            |
+| -------------- | ------------------------------------------------------------------- | -------------------------------------- |
+| **`colors`**   | <code><a href="#taptopaycolorscheme">TapToPayColorScheme</a></code> | Color scheme for the Tap to Pay screen |
+| **`darkMode`** | <code><a href="#taptopaydarkmode">TapToPayDarkMode</a></code>       | Dark mode setting                      |
+| **`tapZone`**  | <code><a href="#taptopaytapzone">TapToPayTapZone</a></code>         | Tap zone position configuration        |
+
+
+#### TapToPayColorScheme
+
+Color scheme for the Tap to Pay screen.
+
+| Prop          | Type                                                    | Description                                                  |
+| ------------- | ------------------------------------------------------- | ------------------------------------------------------------ |
+| **`primary`** | <code><a href="#taptopaycolor">TapToPayColor</a></code> | Primary color (tap zone indicator). Hex string or 'default'. |
+| **`success`** | <code><a href="#taptopaycolor">TapToPayColor</a></code> | Success state color. Hex string or 'default'.                |
+| **`error`**   | <code><a href="#taptopaycolor">TapToPayColor</a></code> | Error state color. Hex string or 'default'.                  |
+
+
 #### PluginListenerHandle
 
 | Prop         | Type                                      |
@@ -962,6 +1002,22 @@ addListener(eventName: TerminalEventsEnum.ReaderReconnectFailed, listenerFunc: (
 <code>{ displayName: string; quantity: number; amount: number; }</code>
 
 
+#### TapToPayColor
+
+Color value for <a href="#taptopayuxconfiguration">TapToPayUxConfiguration</a>.
+Use 'default' to use Stripe's default color, or a hex string like '#965D35'.
+
+<code>'default' | string</code>
+
+
+#### TapToPayTapZone
+
+Tap zone position configuration.
+Controls where the tap indicator appears on screen.
+
+<code>{ type: 'default' } | { type: 'front'; xBias: number; yBias: number } | { type: 'behind'; xBias: number; yBias: number } | { type: 'above'; bias?: number } | { type: 'below'; bias?: number } | { type: 'left'; bias?: number } | { type: 'right'; bias?: number }</code>
+
+
 ### Enums
 
 
@@ -1016,7 +1072,6 @@ addListener(eventName: TerminalEventsEnum.ReaderReconnectFailed, listenerFunc: (
 | **`stripeM2`**         | <code>'stripeM2'</code>         |
 | **`stripeS700`**       | <code>'stripeS700'</code>       |
 | **`stripeS700DevKit`** | <code>'stripeS700Devkit'</code> |
-| **`verifoneP400`**     | <code>'verifoneP400'</code>     |
 | **`wiseCube`**         | <code>'wiseCube'</code>         |
 | **`wisePad3`**         | <code>'wisePad3'</code>         |
 | **`wisePosE`**         | <code>'wisePosE'</code>         |
@@ -1082,6 +1137,15 @@ addListener(eventName: TerminalEventsEnum.ReaderReconnectFailed, listenerFunc: (
 | **`OnlinePinSCARetry`**               | <code>'ONLINE_PIN_SCA_RETRY'</code>               |
 
 
+#### TapToPayDarkMode
+
+| Members      | Value                 |
+| ------------ | --------------------- |
+| **`System`** | <code>'SYSTEM'</code> |
+| **`Dark`**   | <code>'DARK'</code>   |
+| **`Light`**  | <code>'LIGHT'</code>  |
+
+
 #### TerminalEventsEnum
 
 | Members                            | Value                                               |

package/android/build.gradle

@@ -6,9 +6,9 @@ ext {
 
     playServicesWalletVersion = project.hasProperty('playServicesWalletVersion') ? rootProject.ext.playServicesWalletVersion : '19.2.+'
     volleyVersion = project.hasProperty('volleyVersion') ? rootProject.ext.volleyVersion : '1.2.1'
-    stripeterminalTapToPayVersion = project.hasProperty('stripeterminalTapToPayVersion') ? rootProject.ext.stripeterminalTapToPayVersion : '4.7.+'
-    stripeterminalCoreVersion = project.hasProperty('stripeterminalCoreVersion') ? rootProject.ext.stripeterminalCoreVersion : '4.7.+'
-    stripeterminalHandoffClientVersion = project.hasProperty('stripeterminalHandoffClientVersion') ? rootProject.ext.stripeterminalHandoffClientVersion : '4.7.+'
+    stripeterminalTapToPayVersion = project.hasProperty('stripeterminalTapToPayVersion') ? rootProject.ext.stripeterminalTapToPayVersion : '5.3.+'
+    stripeterminalCoreVersion = project.hasProperty('stripeterminalCoreVersion') ? rootProject.ext.stripeterminalCoreVersion : '5.3.+'
+    stripeterminalAppOnDevicesVersion = project.hasProperty('stripeterminalAppOnDevicesVersion') ? rootProject.ext.stripeterminalAppOnDevicesVersion : '5.3.+'
 }
 
 buildscript {
@@ -72,7 +72,7 @@ dependencies {
 
     implementation "com.stripe:stripeterminal-core:$stripeterminalCoreVersion"
     implementation "com.stripe:stripeterminal-taptopay:$stripeterminalTapToPayVersion"
-    implementation "com.stripe:stripeterminal-handoffclient:$stripeterminalHandoffClientVersion"
+    implementation "com.stripe:stripeterminal-appsondevices:$stripeterminalAppOnDevicesVersion"
     implementation "com.android.volley:volley:$volleyVersion"
     implementation "com.google.android.gms:play-services-wallet:$playServicesWalletVersion"
 }

package/android/src/main/java/com/getcapacitor/community/stripe/terminal/StripeTerminal.kt

@@ -6,6 +6,7 @@ import android.app.Application
 import android.bluetooth.BluetoothAdapter
 import android.content.Context
 import android.content.pm.PackageManager
+import android.graphics.Color
 import android.os.Build
 import android.util.Log
 import androidx.core.app.ActivityCompat
@@ -17,7 +18,7 @@ import com.getcapacitor.community.stripe.terminal.helper.TerminalMappers
 import com.getcapacitor.community.stripe.terminal.models.Executor
 import com.google.android.gms.common.util.BiConsumer
 import com.stripe.stripeterminal.Terminal
-import com.stripe.stripeterminal.Terminal.Companion.initTerminal
+import com.stripe.stripeterminal.Terminal.Companion.init
 import com.stripe.stripeterminal.Terminal.Companion.isInitialized
 import com.stripe.stripeterminal.TerminalApplicationDelegate.onCreate
 import com.stripe.stripeterminal.external.callable.Callback
@@ -29,12 +30,12 @@ import com.stripe.stripeterminal.external.callable.PaymentIntentCallback
 import com.stripe.stripeterminal.external.callable.ReaderCallback
 import com.stripe.stripeterminal.external.callable.TapToPayReaderListener
 import com.stripe.stripeterminal.external.callable.TerminalListener
-import com.stripe.stripeterminal.external.callable.HandoffReaderListener
+import com.stripe.stripeterminal.external.callable.AppsOnDevicesListener
 import com.stripe.stripeterminal.external.models.BatteryStatus
 import com.stripe.stripeterminal.external.models.CardPresentDetails
 import com.stripe.stripeterminal.external.models.Cart
 import com.stripe.stripeterminal.external.models.CartLineItem
-import com.stripe.stripeterminal.external.models.CollectConfiguration
+import com.stripe.stripeterminal.external.models.CollectPaymentIntentConfiguration
 import com.stripe.stripeterminal.external.models.ConnectionConfiguration
 import com.stripe.stripeterminal.external.models.ConnectionStatus
 import com.stripe.stripeterminal.external.models.DisconnectReason
@@ -49,6 +50,7 @@ import com.stripe.stripeterminal.external.models.ReaderSoftwareUpdate
 import com.stripe.stripeterminal.external.models.SimulateReaderUpdate
 import com.stripe.stripeterminal.external.models.SimulatedCard
 import com.stripe.stripeterminal.external.models.SimulatorConfiguration
+import com.stripe.stripeterminal.external.models.TapToPayUxConfiguration
 import com.stripe.stripeterminal.external.models.TerminalException
 import com.stripe.stripeterminal.log.LogLevel
 import org.json.JSONException
@@ -128,11 +130,12 @@ class StripeTerminal(
             this.notifyListenersFunction
         )
         if (!isInitialized()) {
-            initTerminal(
+            init(
                 contextSupplier.get().applicationContext,
                 logLevel,
                 this.tokenProvider!!,
-                listener
+                listener,
+                null // OfflineListener - not used in this implementation
             )
         }
         Terminal.getInstance()
@@ -196,18 +199,13 @@ class StripeTerminal(
             config = DiscoveryConfiguration.BluetoothDiscoveryConfiguration(0, this.isTest!!)
             this.terminalConnectType = TerminalConnectTypes.Bluetooth
         } else if (call.getString("type") == TerminalConnectTypes.HandOff.webEventName) {
-            config = DiscoveryConfiguration.HandoffDiscoveryConfiguration()
+            config = DiscoveryConfiguration.AppsOnDevicesDiscoveryConfiguration()
             this.terminalConnectType = TerminalConnectTypes.HandOff
         } else {
             call.unimplemented(call.getString("type") + " is not support now")
             return
         }
 
-        notifyListeners(
-            TerminalEnumEvent.DiscoveringReaders.webEventName,
-            emptyObject
-        )
-
         discoveryCancelable = Terminal.getInstance()
             .discoverReaders(
                 config,
@@ -399,8 +397,8 @@ class StripeTerminal(
 
         val config: ConnectionConfiguration.InternetConnectionConfiguration =
             ConnectionConfiguration.InternetConnectionConfiguration(
-                true,
-                this.internetReaderListener
+                this.internetReaderListener,
+                true
             )
         Terminal.getInstance().connectReader(foundReader, config, this.readerCallback(call))
     }
@@ -461,14 +459,14 @@ class StripeTerminal(
             return
         }
 
-        val config: ConnectionConfiguration.HandoffConnectionConfiguration = ConnectionConfiguration.HandoffConnectionConfiguration(
+        val config: ConnectionConfiguration.AppsOnDevicesConnectionConfiguration = ConnectionConfiguration.AppsOnDevicesConnectionConfiguration(
             this.handoffReaderListener
         )
 
         Terminal.getInstance().connectReader(foundReader, config, this.readerCallback(call))
     }
 
-    var handoffReaderListener: HandoffReaderListener = object : HandoffReaderListener {
+    var handoffReaderListener: AppsOnDevicesListener = object : AppsOnDevicesListener {
         override fun onDisconnect(reason: DisconnectReason) {
             notifyListeners(
                 TerminalEnumEvent.DisconnectedReader.webEventName,
@@ -539,8 +537,8 @@ class StripeTerminal(
     private val createPaymentIntentCallback: PaymentIntentCallback =
         object : PaymentIntentCallback {
             override fun onSuccess(paymentIntent: PaymentIntent) {
-                val collectConfig: CollectConfiguration =
-                    CollectConfiguration.Builder().updatePaymentIntent(true).build()
+                val collectConfig: CollectPaymentIntentConfiguration =
+                    CollectPaymentIntentConfiguration.Builder().updatePaymentIntent(true).build()
                 collectCancelable = Terminal.getInstance().collectPaymentMethod(
                     paymentIntent,
                     collectPaymentMethodCallback,
@@ -902,6 +900,73 @@ class StripeTerminal(
         }
     }
 
+    fun setTapToPayUxConfiguration(call: PluginCall) {
+        try {
+            val builder = TapToPayUxConfiguration.Builder()
+
+            // Parse colors
+            call.getObject("colors")?.let { colorsObj ->
+                val colorSchemeBuilder = TapToPayUxConfiguration.ColorScheme.Builder()
+                colorsObj.getString("primary")?.let { colorSchemeBuilder.primary(parseColor(it)) }
+                colorsObj.getString("success")?.let { colorSchemeBuilder.success(parseColor(it)) }
+                colorsObj.getString("error")?.let { colorSchemeBuilder.error(parseColor(it)) }
+                builder.colors(colorSchemeBuilder.build())
+            }
+
+            // Parse dark mode
+            call.getString("darkMode")?.let { darkModeStr ->
+                val darkMode = when (darkModeStr) {
+                    "DARK" -> TapToPayUxConfiguration.DarkMode.DARK
+                    "LIGHT" -> TapToPayUxConfiguration.DarkMode.LIGHT
+                    else -> TapToPayUxConfiguration.DarkMode.SYSTEM
+                }
+                builder.darkMode(darkMode)
+            }
+
+            // TODO: Tap zone support requires Stripe Terminal SDK v5+
+            // Uncomment when upgrading from v4.7 to v5+
+            // call.getObject("tapZone")?.let { tapZoneObj ->
+            //     val tapZone = when (tapZoneObj.getString("type")) {
+            //         "front" -> TapToPayUxConfiguration.TapZone.Front(
+            //             tapZoneObj.getDouble("xBias")?.toFloat() ?: 0.5f,
+            //             tapZoneObj.getDouble("yBias")?.toFloat() ?: 0.5f
+            //         )
+            //         "behind" -> TapToPayUxConfiguration.TapZone.Behind(
+            //             tapZoneObj.getDouble("xBias")?.toFloat() ?: 0.5f,
+            //             tapZoneObj.getDouble("yBias")?.toFloat() ?: 0.5f
+            //         )
+            //         "above" -> TapToPayUxConfiguration.TapZone.Above(
+            //             tapZoneObj.getDouble("bias")?.toFloat() ?: 0.5f
+            //         )
+            //         "below" -> TapToPayUxConfiguration.TapZone.Below(
+            //             tapZoneObj.getDouble("bias")?.toFloat() ?: 0.5f
+            //         )
+            //         "left" -> TapToPayUxConfiguration.TapZone.Left(
+            //             tapZoneObj.getDouble("bias")?.toFloat() ?: 0.5f
+            //         )
+            //         "right" -> TapToPayUxConfiguration.TapZone.Right(
+            //             tapZoneObj.getDouble("bias")?.toFloat() ?: 0.5f
+            //         )
+            //         else -> TapToPayUxConfiguration.TapZone.Default
+            //     }
+            //     builder.tapZone(tapZone)
+            // }
+
+            Terminal.getInstance().setTapToPayUxConfiguration(builder.build())
+            call.resolve()
+        } catch (ex: Exception) {
+            call.reject(ex.message)
+        }
+    }
+
+    private fun parseColor(colorStr: String): TapToPayUxConfiguration.Color {
+        return if (colorStr == "default") {
+            TapToPayUxConfiguration.Color.Default
+        } else {
+            TapToPayUxConfiguration.Color.Value(Color.parseColor(colorStr))
+        }
+    }
+
     private fun convertReaderInterface(reader: Reader?): JSObject {
         return JSObject()
             .put("label", reader!!.label)

package/android/src/main/java/com/getcapacitor/community/stripe/terminal/StripeTerminalPlugin.kt

@@ -106,11 +106,6 @@ class StripeTerminalPlugin : Plugin() {
                 "type"
             ) == TerminalConnectTypes.Simulated.webEventName
         ) {
-            Log.d(
-                "Capacitor:permission bluetooth_old",
-                getPermissionState("bluetooth_old").toString()
-            )
-            Log.d("Capacitor:permission bluetooth", getPermissionState("bluetooth").toString())
             if (Build.VERSION.SDK_INT <= 30 && getPermissionState("bluetooth_old") != PermissionState.GRANTED) {
                 requestPermissionForAlias("bluetooth_old", call, "bluetoothOldPermsCallback")
             } else if (Build.VERSION.SDK_INT > 30 && getPermissionState("bluetooth") != PermissionState.GRANTED) {
@@ -202,4 +197,9 @@ class StripeTerminalPlugin : Plugin() {
     fun cancelReaderReconnection(call: PluginCall) {
         implementation.cancelReaderReconnection(call)
     }
+
+    @PluginMethod
+    fun setTapToPayUxConfiguration(call: PluginCall) {
+        implementation.setTapToPayUxConfiguration(call)
+    }
 }

package/android/src/main/java/com/getcapacitor/community/stripe/terminal/helper/TerminalMappers.kt

@@ -78,7 +78,6 @@ class TerminalMappers {
             DeviceType.STRIPE_S700 -> "stripeS700"
             DeviceType.STRIPE_S700_DEVKIT -> "stripeS700Devkit"
             DeviceType.UNKNOWN -> "unknown"
-            DeviceType.VERIFONE_P400 -> "verifoneP400"
             DeviceType.WISECUBE -> "wiseCube"
             DeviceType.WISEPAD_3 -> "wisePad3"
             DeviceType.WISEPAD_3S -> "wisePad3s"

package/dist/docs.json

@@ -235,6 +235,24 @@
         "complexTypes": [],
         "slug": "cancelreaderreconnection"
       },
+      {
+        "name": "setTapToPayUxConfiguration",
+        "signature": "(options: TapToPayUxConfiguration) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "TapToPayUxConfiguration"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "Configure the Tap to Pay UX appearance (Android only).\nCall this after initialize() but before connectReader().\nHas no effect on iOS or web platforms.",
+        "complexTypes": [
+          "TapToPayUxConfiguration"
+        ],
+        "slug": "settaptopayuxconfiguration"
+      },
       {
         "name": "addListener",
         "signature": "(eventName: TerminalEventsEnum.Loaded, listenerFunc: () => void) => Promise<PluginListenerHandle>",
@@ -839,6 +857,80 @@
         }
       ]
     },
+    {
+      "name": "TapToPayUxConfiguration",
+      "slug": "taptopayuxconfiguration",
+      "docs": "Configuration for the Tap to Pay UX (Android only).",
+      "tags": [],
+      "extends": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "colors",
+          "tags": [],
+          "docs": "Color scheme for the Tap to Pay screen",
+          "complexTypes": [
+            "TapToPayColorScheme"
+          ],
+          "type": "TapToPayColorScheme"
+        },
+        {
+          "name": "darkMode",
+          "tags": [],
+          "docs": "Dark mode setting",
+          "complexTypes": [
+            "TapToPayDarkMode"
+          ],
+          "type": "TapToPayDarkMode"
+        },
+        {
+          "name": "tapZone",
+          "tags": [],
+          "docs": "Tap zone position configuration",
+          "complexTypes": [
+            "TapToPayTapZone"
+          ],
+          "type": "TapToPayTapZone"
+        }
+      ]
+    },
+    {
+      "name": "TapToPayColorScheme",
+      "slug": "taptopaycolorscheme",
+      "docs": "Color scheme for the Tap to Pay screen.",
+      "tags": [],
+      "extends": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "primary",
+          "tags": [],
+          "docs": "Primary color (tap zone indicator). Hex string or 'default'.",
+          "complexTypes": [
+            "TapToPayColor"
+          ],
+          "type": "TapToPayColor"
+        },
+        {
+          "name": "success",
+          "tags": [],
+          "docs": "Success state color. Hex string or 'default'.",
+          "complexTypes": [
+            "TapToPayColor"
+          ],
+          "type": "TapToPayColor"
+        },
+        {
+          "name": "error",
+          "tags": [],
+          "docs": "Error state color. Hex string or 'default'.",
+          "complexTypes": [
+            "TapToPayColor"
+          ],
+          "type": "TapToPayColor"
+        }
+      ]
+    },
     {
       "name": "PluginListenerHandle",
       "slug": "pluginlistenerhandle",
@@ -1024,12 +1116,6 @@
           "tags": [],
           "docs": ""
         },
-        {
-          "name": "verifoneP400",
-          "value": "'verifoneP400'",
-          "tags": [],
-          "docs": ""
-        },
         {
           "name": "wiseCube",
           "value": "'wiseCube'",
@@ -1320,6 +1406,30 @@
         }
       ]
     },
+    {
+      "name": "TapToPayDarkMode",
+      "slug": "taptopaydarkmode",
+      "members": [
+        {
+          "name": "System",
+          "value": "'SYSTEM'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "Dark",
+          "value": "'DARK'",
+          "tags": [],
+          "docs": ""
+        },
+        {
+          "name": "Light",
+          "value": "'LIGHT'",
+          "tags": [],
+          "docs": ""
+        }
+      ]
+    },
     {
       "name": "TerminalEventsEnum",
       "slug": "terminaleventsenum",
@@ -1796,6 +1906,56 @@
           "complexTypes": []
         }
       ]
+    },
+    {
+      "name": "TapToPayColor",
+      "slug": "taptopaycolor",
+      "docs": "Color value for TapToPayUxConfiguration.\nUse 'default' to use Stripe's default color, or a hex string like '#965D35'.",
+      "types": [
+        {
+          "text": "'default'",
+          "complexTypes": []
+        },
+        {
+          "text": "string",
+          "complexTypes": []
+        }
+      ]
+    },
+    {
+      "name": "TapToPayTapZone",
+      "slug": "taptopaytapzone",
+      "docs": "Tap zone position configuration.\nControls where the tap indicator appears on screen.",
+      "types": [
+        {
+          "text": "{ type: 'default' }",
+          "complexTypes": []
+        },
+        {
+          "text": "{ type: 'front'; xBias: number; yBias: number }",
+          "complexTypes": []
+        },
+        {
+          "text": "{ type: 'behind'; xBias: number; yBias: number }",
+          "complexTypes": []
+        },
+        {
+          "text": "{ type: 'above'; bias?: number }",
+          "complexTypes": []
+        },
+        {
+          "text": "{ type: 'below'; bias?: number }",
+          "complexTypes": []
+        },
+        {
+          "text": "{ type: 'left'; bias?: number }",
+          "complexTypes": []
+        },
+        {
+          "text": "{ type: 'right'; bias?: number }",
+          "complexTypes": []
+        }
+      ]
     }
   ],
   "pluginConfigs": []

package/dist/esm/definitions.d.ts

@@ -67,6 +67,68 @@ export type Cart = {
     total: number;
     lineItems: CartLineItem[];
 };
+/**
+ * Color value for TapToPayUxConfiguration.
+ * Use 'default' to use Stripe's default color, or a hex string like '#965D35'.
+ */
+export type TapToPayColor = 'default' | string;
+/**
+ * Dark mode setting for Tap to Pay UX.
+ */
+export declare enum TapToPayDarkMode {
+    System = "SYSTEM",
+    Dark = "DARK",
+    Light = "LIGHT"
+}
+/**
+ * Color scheme for the Tap to Pay screen.
+ */
+export interface TapToPayColorScheme {
+    /** Primary color (tap zone indicator). Hex string or 'default'. */
+    primary?: TapToPayColor;
+    /** Success state color. Hex string or 'default'. */
+    success?: TapToPayColor;
+    /** Error state color. Hex string or 'default'. */
+    error?: TapToPayColor;
+}
+/**
+ * Tap zone position configuration.
+ * Controls where the tap indicator appears on screen.
+ */
+export type TapToPayTapZone = {
+    type: 'default';
+} | {
+    type: 'front';
+    xBias: number;
+    yBias: number;
+} | {
+    type: 'behind';
+    xBias: number;
+    yBias: number;
+} | {
+    type: 'above';
+    bias?: number;
+} | {
+    type: 'below';
+    bias?: number;
+} | {
+    type: 'left';
+    bias?: number;
+} | {
+    type: 'right';
+    bias?: number;
+};
+/**
+ * Configuration for the Tap to Pay UX (Android only).
+ */
+export interface TapToPayUxConfiguration {
+    /** Color scheme for the Tap to Pay screen */
+    colors?: TapToPayColorScheme;
+    /** Dark mode setting */
+    darkMode?: TapToPayDarkMode;
+    /** Tap zone position configuration */
+    tapZone?: TapToPayTapZone;
+}
 export interface DiscoverReadersOptions {
     type: TerminalConnectTypes;
     locationId?: string;
@@ -132,6 +194,12 @@ export interface StripeTerminalPlugin {
     clearReaderDisplay(): Promise<void>;
     rebootReader(): Promise<void>;
     cancelReaderReconnection(): Promise<void>;
+    /**
+     * Configure the Tap to Pay UX appearance (Android only).
+     * Call this after initialize() but before connectReader().
+     * Has no effect on iOS or web platforms.
+     */
+    setTapToPayUxConfiguration(options: TapToPayUxConfiguration): Promise<void>;
     addListener(eventName: TerminalEventsEnum.Loaded, listenerFunc: () => void): Promise<PluginListenerHandle>;
     addListener(eventName: TerminalEventsEnum.RequestedConnectionToken, listenerFunc: () => void): Promise<PluginListenerHandle>;
     /**

package/dist/esm/definitions.js

@@ -1,3 +1,12 @@
+/**
+ * Dark mode setting for Tap to Pay UX.
+ */
+export var TapToPayDarkMode;
+(function (TapToPayDarkMode) {
+    TapToPayDarkMode["System"] = "SYSTEM";
+    TapToPayDarkMode["Dark"] = "DARK";
+    TapToPayDarkMode["Light"] = "LIGHT";
+})(TapToPayDarkMode || (TapToPayDarkMode = {}));
 export * from './events.enum';
 export * from './stripe.enum';
 //# sourceMappingURL=definitions.js.map