@capacitor-community/stripe-terminal 6.0.2 → 6.1.0

package/CapacitorCommunityStripeTerminal.podspec

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

package/README.md

@@ -116,6 +116,7 @@ And update minSdkVersion to 26 And compileSdkVersion to 34 in your `android/app/
 * [`initialize(...)`](#initialize)
 * [`discoverReaders(...)`](#discoverreaders)
 * [`setConnectionToken(...)`](#setconnectiontoken)
+* [`setSimulatorConfiguration(...)`](#setsimulatorconfiguration)
 * [`connectReader(...)`](#connectreader)
 * [`getConnectedReader()`](#getconnectedreader)
 * [`disconnectReader()`](#disconnectreader)
@@ -127,10 +128,22 @@ And update minSdkVersion to 26 And compileSdkVersion to 34 in your `android/app/
 * [`addListener(TerminalEventsEnum.RequestedConnectionToken, ...)`](#addlistenerterminaleventsenumrequestedconnectiontoken)
 * [`addListener(TerminalEventsEnum.DiscoveredReaders, ...)`](#addlistenerterminaleventsenumdiscoveredreaders)
 * [`addListener(TerminalEventsEnum.ConnectedReader, ...)`](#addlistenerterminaleventsenumconnectedreader)
+* [`addListener(TerminalEventsEnum.DisconnectedReader, ...)`](#addlistenerterminaleventsenumdisconnectedreader)
+* [`addListener(TerminalEventsEnum.ConnectionStatusChange, ...)`](#addlistenerterminaleventsenumconnectionstatuschange)
+* [`addListener(TerminalEventsEnum.UnexpectedReaderDisconnect, ...)`](#addlistenerterminaleventsenumunexpectedreaderdisconnect)
 * [`addListener(TerminalEventsEnum.ConfirmedPaymentIntent, ...)`](#addlistenerterminaleventsenumconfirmedpaymentintent)
 * [`addListener(TerminalEventsEnum.CollectedPaymentIntent, ...)`](#addlistenerterminaleventsenumcollectedpaymentintent)
 * [`addListener(TerminalEventsEnum.Canceled, ...)`](#addlistenerterminaleventsenumcanceled)
 * [`addListener(TerminalEventsEnum.Failed, ...)`](#addlistenerterminaleventsenumfailed)
+* [`addListener(TerminalEventsEnum.ReportAvailableUpdate, ...)`](#addlistenerterminaleventsenumreportavailableupdate)
+* [`addListener(TerminalEventsEnum.StartInstallingUpdate, ...)`](#addlistenerterminaleventsenumstartinstallingupdate)
+* [`addListener(TerminalEventsEnum.ReaderSoftwareUpdateProgress, ...)`](#addlistenerterminaleventsenumreadersoftwareupdateprogress)
+* [`addListener(TerminalEventsEnum.FinishInstallingUpdate, ...)`](#addlistenerterminaleventsenumfinishinstallingupdate)
+* [`addListener(TerminalEventsEnum.BatteryLevel, ...)`](#addlistenerterminaleventsenumbatterylevel)
+* [`addListener(TerminalEventsEnum.ReaderEvent, ...)`](#addlistenerterminaleventsenumreaderevent)
+* [`addListener(TerminalEventsEnum.RequestDisplayMessage, ...)`](#addlistenerterminaleventsenumrequestdisplaymessage)
+* [`addListener(TerminalEventsEnum.RequestReaderInput, ...)`](#addlistenerterminaleventsenumrequestreaderinput)
+* [`addListener(TerminalEventsEnum.PaymentStatusChange, ...)`](#addlistenerterminaleventsenumpaymentstatuschange)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 * [Enums](#enums)
@@ -181,6 +194,21 @@ setConnectionToken(options: { token: string; }) => Promise<void>
 --------------------
 
 
+### setSimulatorConfiguration(...)
+
+```typescript
+setSimulatorConfiguration(options: { update?: SimulateReaderUpdate; simulatedCard?: SimulatedCardType; simulatedTipAmount?: number; }) => Promise<void>
+```
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.models/-simulator-configuration/index.html)
+
+| Param         | Type                                                                                                                                                                                 |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **`options`** | <code>{ update?: <a href="#simulatereaderupdate">SimulateReaderUpdate</a>; simulatedCard?: <a href="#simulatedcardtype">SimulatedCardType</a>; simulatedTipAmount?: number; }</code> |
+
+--------------------
+
+
 ### connectReader(...)
 
 ```typescript
@@ -289,13 +317,13 @@ addListener(eventName: TerminalEventsEnum.RequestedConnectionToken, listenerFunc
 ### addListener(TerminalEventsEnum.DiscoveredReaders, ...)
 
 ```typescript
-addListener(eventName: TerminalEventsEnum.DiscoveredReaders, listenerFunc: () => { reader: ReaderInterface; }) => Promise<PluginListenerHandle>
+addListener(eventName: TerminalEventsEnum.DiscoveredReaders, listenerFunc: ({ readers }: { readers: ReaderInterface[]; }) => void) => Promise<PluginListenerHandle>
 ```
 
 | Param              | Type                                                                                |
 | ------------------ | ----------------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.DiscoveredReaders</a></code> |
-| **`listenerFunc`** | <code>() =&gt; { reader: <a href="#readerinterface">ReaderInterface</a>; }</code>   |
+| **`listenerFunc`** | <code>({ readers }: { readers: ReaderInterface[]; }) =&gt; void</code>              |
 
 **Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
 
@@ -318,6 +346,88 @@ addListener(eventName: TerminalEventsEnum.ConnectedReader, listenerFunc: () => v
 --------------------
 
 
+### addListener(TerminalEventsEnum.DisconnectedReader, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.DisconnectedReader, listenerFunc: ({ reason }: { reason?: DisconnectReason | undefined; }) => void) => Promise<PluginListenerHandle>
+```
+
+Emitted when the reader is disconnected, either in response to [`disconnectReader()`](#disconnectreader)
+or some connection error.
+
+For all reader types, this is emitted in response to [`disconnectReader()`](#disconnectreader)
+without a `reason` property.
+
+For Bluetooth and USB readers, this is emitted with a `reason` property when the reader disconnects.
+
+**Note:** For Bluetooth and USB readers, when you call [`disconnectReader()`](#disconnectreader), this event
+will be emitted twice: one without a `reason` in acknowledgement of your call, and again with a `reason` when the reader
+finishes disconnecting.
+
+| Param              | Type                                                                                                 |
+| ------------------ | ---------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.DisconnectedReader</a></code>                 |
+| **`listenerFunc`** | <code>({ reason }: { reason?: <a href="#disconnectreason">DisconnectReason</a>; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.ConnectionStatusChange, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.ConnectionStatusChange, listenerFunc: ({ status }: { status: ConnectionStatus; }) => void) => Promise<PluginListenerHandle>
+```
+
+Emitted when the Terminal's connection status changed.
+
+Note: You should *not* use this method to detect when a reader unexpectedly disconnects from your app,
+as it cannot be used to accurately distinguish between expected and unexpected disconnect events.
+
+To detect unexpected disconnects (e.g. to automatically notify your user), you should instead use
+the UnexpectedReaderDisconnect event.
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-terminal-listener/on-connection-status-change.html)
+
+| Param              | Type                                                                                                |
+| ------------------ | --------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.ConnectionStatusChange</a></code>            |
+| **`listenerFunc`** | <code>({ status }: { status: <a href="#connectionstatus">ConnectionStatus</a>; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.UnexpectedReaderDisconnect, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.UnexpectedReaderDisconnect, listenerFunc: ({ reader }: { reader: ReaderInterface; }) => void) => Promise<PluginListenerHandle>
+```
+
+The Terminal disconnected unexpectedly from the reader.
+
+In your implementation of this method, you may want to notify your user that the reader disconnected.
+You may also call [`discoverReaders()`](#discoverreaders) to begin scanning for readers, and attempt
+to automatically reconnect to the disconnected reader. Be sure to either set a timeout or make it
+possible to cancel calls to `discoverReaders()`
+
+When connected to a Bluetooth or USB reader, you can get more information about the disconnect by
+implementing the DisconnectedReader event.
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-terminal-listener/on-unexpected-reader-disconnect.html)
+
+| Param              | Type                                                                                              |
+| ------------------ | ------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.UnexpectedReaderDisconnect</a></code>      |
+| **`listenerFunc`** | <code>({ reader }: { reader: <a href="#readerinterface">ReaderInterface</a>; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### addListener(TerminalEventsEnum.ConfirmedPaymentIntent, ...)
 
 ```typescript
@@ -356,6 +466,9 @@ addListener(eventName: TerminalEventsEnum.CollectedPaymentIntent, listenerFunc:
 addListener(eventName: TerminalEventsEnum.Canceled, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Emitted when [`cancelCollectPaymentMethod()`](#cancelcollectpaymentmethod) is called and succeeds.
+The Promise returned by `cancelCollectPaymentMethod()` will also be resolved.
+
 | Param              | Type                                                                       |
 | ------------------ | -------------------------------------------------------------------------- |
 | **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.Canceled</a></code> |
@@ -372,6 +485,9 @@ addListener(eventName: TerminalEventsEnum.Canceled, listenerFunc: () => void) =>
 addListener(eventName: TerminalEventsEnum.Failed, listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
+Emitted when either [`collectPaymentMethod()`](#collectpaymentmethod) or [`confirmPaymentIntent()`](#confirmpaymentintent)
+fails. The Promise returned by the relevant call will also be rejected.
+
 | Param              | Type                                                                     |
 | ------------------ | ------------------------------------------------------------------------ |
 | **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.Failed</a></code> |
@@ -382,6 +498,208 @@ addListener(eventName: TerminalEventsEnum.Failed, listenerFunc: () => void) => P
 --------------------
 
 
+### addListener(TerminalEventsEnum.ReportAvailableUpdate, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.ReportAvailableUpdate, listenerFunc: ({ update, }: { update: ReaderSoftwareUpdateInterface; }) => void) => Promise<PluginListenerHandle>
+```
+
+Emitted when a software update is available for the connected reader.
+
+| Param              | Type                                                                                                                           |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.ReportAvailableUpdate</a></code>                                        |
+| **`listenerFunc`** | <code>({ update, }: { update: <a href="#readersoftwareupdateinterface">ReaderSoftwareUpdateInterface</a>; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.StartInstallingUpdate, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.StartInstallingUpdate, listenerFunc: ({ update, }: { update: ReaderSoftwareUpdateInterface; }) => void) => Promise<PluginListenerHandle>
+```
+
+**Only applicable to Bluetooth and USB readers.**
+
+Emitted when the connected reader begins installing a software update.
+If a mandatory software update is available when a reader first connects, that update is
+automatically installed. The update will be installed before ConnectedReader is emitted and
+before the Promise returned by [`connectReader()`](#connectreader) resolves.
+In this case, you will receive this sequence of events:
+
+1. StartInstallingUpdate
+2. ReaderSoftwareUpdateProgress (repeatedly)
+3. FinishInstallingUpdates
+4. ConnectedReader
+5. `connectReader()` Promise resolves
+
+Your app should show UI to the user indiciating that a software update is being installed
+to explain why connecting is taking longer than usual.
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-reader-listener/on-start-installing-update.html)
+
+| Param              | Type                                                                                                                           |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.StartInstallingUpdate</a></code>                                        |
+| **`listenerFunc`** | <code>({ update, }: { update: <a href="#readersoftwareupdateinterface">ReaderSoftwareUpdateInterface</a>; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.ReaderSoftwareUpdateProgress, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.ReaderSoftwareUpdateProgress, listenerFunc: ({ progress }: { progress: number; }) => void) => Promise<PluginListenerHandle>
+```
+
+**Only applicable to Bluetooth and USB readers.**
+
+Emitted periodically while reader software is updating to inform of the installation progress.
+`progress` is a float between 0 and 1.
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-reader-listener/on-report-reader-software-update-progress.html)
+
+| Param              | Type                                                                                           |
+| ------------------ | ---------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.ReaderSoftwareUpdateProgress</a></code> |
+| **`listenerFunc`** | <code>({ progress }: { progress: number; }) =&gt; void</code>                                  |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.FinishInstallingUpdate, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.FinishInstallingUpdate, listenerFunc: (args: { update: ReaderSoftwareUpdateInterface; } | { error: string; }) => void) => Promise<PluginListenerHandle>
+```
+
+**Only applicable to Bluetooth and USB readers.**
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-reader-listener/on-finish-installing-update.html)
+
+| Param              | Type                                                                                                                                          |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.FinishInstallingUpdate</a></code>                                                      |
+| **`listenerFunc`** | <code>(args: { update: <a href="#readersoftwareupdateinterface">ReaderSoftwareUpdateInterface</a>; } \| { error: string; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.BatteryLevel, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.BatteryLevel, listenerFunc: ({ level, charging, status, }: { level: number; charging: boolean; status: BatteryStatus; }) => void) => Promise<PluginListenerHandle>
+```
+
+**Only applicable to Bluetooth and USB readers.**
+
+Emitted upon connection and every 10 minutes.
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-reader-listener/on-battery-level-update.html)
+
+| Param              | Type                                                                                                                                              |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.BatteryLevel</a></code>                                                                    |
+| **`listenerFunc`** | <code>({ level, charging, status, }: { level: number; charging: boolean; status: <a href="#batterystatus">BatteryStatus</a>; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.ReaderEvent, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.ReaderEvent, listenerFunc: ({ event }: { event: ReaderEvent; }) => void) => Promise<PluginListenerHandle>
+```
+
+**Only applicable to Bluetooth and USB readers.**
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-reader-listenable/on-report-reader-event.html)
+
+| Param              | Type                                                                                    |
+| ------------------ | --------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.ReaderEvent</a></code>           |
+| **`listenerFunc`** | <code>({ event }: { event: <a href="#readerevent">ReaderEvent</a>; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.RequestDisplayMessage, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.RequestDisplayMessage, listenerFunc: ({ messageType, message, }: { messageType: ReaderDisplayMessage; message: string; }) => void) => Promise<PluginListenerHandle>
+```
+
+**Only applicable to Bluetooth and USB readers.**
+
+Emitted when the Terminal requests that a message be displayed in your app.
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-reader-listener/on-request-reader-display-message.html)
+
+| Param              | Type                                                                                                                                             |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.RequestDisplayMessage</a></code>                                                          |
+| **`listenerFunc`** | <code>({ messageType, message, }: { messageType: <a href="#readerdisplaymessage">ReaderDisplayMessage</a>; message: string; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.RequestReaderInput, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.RequestReaderInput, listenerFunc: ({ options, message, }: { options: ReaderInputOption[]; message: string; }) => void) => Promise<PluginListenerHandle>
+```
+
+**Only applicable to Bluetooth and USB readers.**
+
+Emitted when the reader begins waiting for input. Your app should prompt the customer
+to present a source using one of the given input options. If the reader emits a message,
+the RequestDisplayMessage event will be emitted.
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-reader-listener/on-request-reader-input.html)
+
+| Param              | Type                                                                                                |
+| ------------------ | --------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.RequestReaderInput</a></code>                |
+| **`listenerFunc`** | <code>({ options, message, }: { options: ReaderInputOption[]; message: string; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(TerminalEventsEnum.PaymentStatusChange, ...)
+
+```typescript
+addListener(eventName: TerminalEventsEnum.PaymentStatusChange, listenerFunc: ({ status }: { status: PaymentStatus; }) => void) => Promise<PluginListenerHandle>
+```
+
+[*Stripe docs reference*](https://stripe.dev/stripe-terminal-android/external/com.stripe.stripeterminal.external.callable/-terminal-listener/on-payment-status-change.html)
+
+| Param              | Type                                                                                          |
+| ------------------ | --------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#terminaleventsenum">TerminalEventsEnum.PaymentStatusChange</a></code>         |
+| **`listenerFunc`** | <code>({ status }: { status: <a href="#paymentstatus">PaymentStatus</a>; }) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -400,6 +718,11 @@ addListener(eventName: TerminalEventsEnum.Failed, listenerFunc: () => void) => P
 <code>{ index: number; serialNumber: string; }</code>
 
 
+#### ReaderSoftwareUpdateInterface
+
+<code>{ version: string; settingsVersion: string; requiredAt: number; timeEstimate: <a href="#updatetimeestimate">UpdateTimeEstimate</a>; }</code>
+
+
 ### Enums
 
 
@@ -414,19 +737,166 @@ addListener(eventName: TerminalEventsEnum.Failed, listenerFunc: () => void) => P
 | **`TapToPay`**  | <code>'tap-to-pay'</code> |
 
 
+#### SimulateReaderUpdate
+
+| Members                        | Value                                      |
+| ------------------------------ | ------------------------------------------ |
+| **`UpdateAvailable`**          | <code>'UPDATE_AVAILABLE'</code>            |
+| **`None`**                     | <code>'NONE'</code>                        |
+| **`Required`**                 | <code>'REQUIRED'</code>                    |
+| **`Random`**                   | <code>'RANDOM'</code>                      |
+| **`LowBattery`**               | <code>'LOW_BATTERY'</code>                 |
+| **`LowBatterySucceedConnect`** | <code>'LOW_BATTERY_SUCCEED_CONNECT'</code> |
+
+
+#### SimulatedCardType
+
+| Members                               | Value                                             |
+| ------------------------------------- | ------------------------------------------------- |
+| **`Visa`**                            | <code>'VISA'</code>                               |
+| **`VisaDebit`**                       | <code>'VISA_DEBIT'</code>                         |
+| **`Mastercard`**                      | <code>'MASTERCARD'</code>                         |
+| **`MastercardDebit`**                 | <code>'MASTERCARD_DEBIT'</code>                   |
+| **`MastercardPrepaid`**               | <code>'MASTERCARD_PREPAID'</code>                 |
+| **`Amex`**                            | <code>'AMEX'</code>                               |
+| **`Amex2`**                           | <code>'AMEX_2'</code>                             |
+| **`Discover`**                        | <code>'DISCOVER'</code>                           |
+| **`Discover2`**                       | <code>'DISCOVER_2'</code>                         |
+| **`DinersClub`**                      | <code>'DINERS'</code>                             |
+| **`DinersClulb14Digits`**             | <code>'DINERS_14_DIGITS'</code>                   |
+| **`JCB`**                             | <code>'JCB'</code>                                |
+| **`UnionPay`**                        | <code>'UNION_PAY'</code>                          |
+| **`Interac`**                         | <code>'INTERAC'</code>                            |
+| **`EftposAustraliaDebit`**            | <code>'EFTPOS_AU_DEBIT'</code>                    |
+| **`VisaUsCommonDebit`**               | <code>'VISA_US_COMMON_DEBIT'</code>               |
+| **`ChargeDeclined`**                  | <code>'CHARGE_DECLINED'</code>                    |
+| **`ChargeDeclinedInsufficientFunds`** | <code>'CHARGE_DECLINED_INSUFFICIENT_FUNDS'</code> |
+| **`ChargeDeclinedLostCard`**          | <code>'CHARGE_DECLINED_LOST_CARD'</code>          |
+| **`ChargeDeclinedStolenCard`**        | <code>'CHARGE_DECLINED_STOLEN_CARD'</code>        |
+| **`ChargeDeclinedExpiredCard`**       | <code>'CHARGE_DECLINED_EXPIRED_CARD'</code>       |
+| **`ChargeDeclinedProcessingError`**   | <code>'CHARGE_DECLINED_PROCESSING_ERROR'</code>   |
+| **`EftposAustraliaVisaDebit`**        | <code>'EFTPOS_AU_VISA_DEBIT'</code>               |
+| **`EftposAustraliaMastercardDebit`**  | <code>'EFTPOS_AU_DEBIT_MASTERCARD'</code>         |
+| **`OfflinePinCVM`**                   | <code>'OFFLINE_PIN_CVM'</code>                    |
+| **`OfflinePinSCARetry`**              | <code>'OFFLINE_PIN_SCA_RETRY'</code>              |
+| **`OnlinePinCVM`**                    | <code>'ONLINE_PIN_CVM'</code>                     |
+| **`OnlinePinSCARetry`**               | <code>'ONLINE_PIN_SCA_RETRY'</code>               |
+
+
 #### TerminalEventsEnum
 
-| Members                        | Value                                           |
-| ------------------------------ | ----------------------------------------------- |
-| **`Loaded`**                   | <code>'terminalLoaded'</code>                   |
-| **`DiscoveredReaders`**        | <code>'terminalDiscoveredReaders'</code>        |
-| **`CancelDiscoveredReaders`**  | <code>'terminalCancelDiscoveredReaders'</code>  |
-| **`ConnectedReader`**          | <code>'terminalConnectedReader'</code>          |
-| **`DisconnectedReader`**       | <code>'terminalDisconnectedReader'</code>       |
-| **`ConfirmedPaymentIntent`**   | <code>'terminalConfirmedPaymentIntent'</code>   |
-| **`CollectedPaymentIntent`**   | <code>'terminalCollectedPaymentIntent'</code>   |
-| **`Canceled`**                 | <code>'terminalCanceled'</code>                 |
-| **`Failed`**                   | <code>'terminalFailed'</code>                   |
-| **`RequestedConnectionToken`** | <code>'terminalRequestedConnectionToken'</code> |
+| Members                            | Value                                               |
+| ---------------------------------- | --------------------------------------------------- |
+| **`Loaded`**                       | <code>'terminalLoaded'</code>                       |
+| **`DiscoveredReaders`**            | <code>'terminalDiscoveredReaders'</code>            |
+| **`CancelDiscoveredReaders`**      | <code>'terminalCancelDiscoveredReaders'</code>      |
+| **`ConnectedReader`**              | <code>'terminalConnectedReader'</code>              |
+| **`DisconnectedReader`**           | <code>'terminalDisconnectedReader'</code>           |
+| **`ConnectionStatusChange`**       | <code>'terminalConnectionStatusChange'</code>       |
+| **`UnexpectedReaderDisconnect`**   | <code>'terminalUnexpectedReaderDisconnect'</code>   |
+| **`ConfirmedPaymentIntent`**       | <code>'terminalConfirmedPaymentIntent'</code>       |
+| **`CollectedPaymentIntent`**       | <code>'terminalCollectedPaymentIntent'</code>       |
+| **`Canceled`**                     | <code>'terminalCanceled'</code>                     |
+| **`Failed`**                       | <code>'terminalFailed'</code>                       |
+| **`RequestedConnectionToken`**     | <code>'terminalRequestedConnectionToken'</code>     |
+| **`ReportAvailableUpdate`**        | <code>'terminalReportAvailableUpdate'</code>        |
+| **`StartInstallingUpdate`**        | <code>'terminalStartInstallingUpdate'</code>        |
+| **`ReaderSoftwareUpdateProgress`** | <code>'terminalReaderSoftwareUpdateProgress'</code> |
+| **`FinishInstallingUpdate`**       | <code>'terminalFinishInstallingUpdate'</code>       |
+| **`BatteryLevel`**                 | <code>'terminalBatteryLevel'</code>                 |
+| **`ReaderEvent`**                  | <code>'terminalReaderEvent'</code>                  |
+| **`RequestDisplayMessage`**        | <code>'terminalRequestDisplayMessage'</code>        |
+| **`RequestReaderInput`**           | <code>'terminalRequestReaderInput'</code>           |
+| **`PaymentStatusChange`**          | <code>'terminalPaymentStatusChange'</code>          |
+
+
+#### DisconnectReason
+
+| Members                    | Value                                 |
+| -------------------------- | ------------------------------------- |
+| **`Unknown`**              | <code>'UNKNOWN'</code>                |
+| **`DisconnectRequested`**  | <code>'DISCONNECT_REQUESTED'</code>   |
+| **`RebootRequested`**      | <code>'REBOOT_REQUESTED'</code>       |
+| **`SecurityReboot`**       | <code>'SECURITY_REBOOT'</code>        |
+| **`CriticallyLowBattery`** | <code>'CRITICALLY_LOW_BATTERY'</code> |
+| **`PoweredOff`**           | <code>'POWERED_OFF'</code>            |
+| **`BluetoothDisabled`**    | <code>'BLUETOOTH_DISABLED'</code>     |
+
+
+#### ConnectionStatus
+
+| Members            | Value                        |
+| ------------------ | ---------------------------- |
+| **`Unknown`**      | <code>'UNKNOWN'</code>       |
+| **`NotConnected`** | <code>'NOT_CONNECTED'</code> |
+| **`Connecting`**   | <code>'CONNECTING'</code>    |
+| **`Connected`**    | <code>'CONNECTED'</code>     |
+
+
+#### UpdateTimeEstimate
+
+| Members                    | Value                                  |
+| -------------------------- | -------------------------------------- |
+| **`LessThanOneMinute`**    | <code>'LESS_THAN_ONE_MINUTE'</code>    |
+| **`OneToTwoMinutes`**      | <code>'ONE_TO_TWO_MINUTES'</code>      |
+| **`TwoToFiveMinutes`**     | <code>'TWO_TO_FIVE_MINUTES'</code>     |
+| **`FiveToFifteenMinutes`** | <code>'FIVE_TO_FIFTEEN_MINUTES'</code> |
+
+
+#### BatteryStatus
+
+| Members        | Value                   |
+| -------------- | ----------------------- |
+| **`Unknown`**  | <code>'UNKNOWN'</code>  |
+| **`Critical`** | <code>'CRITICAL'</code> |
+| **`Low`**      | <code>'LOW'</code>      |
+| **`Nominal`**  | <code>'NOMINAL'</code>  |
+
+
+#### ReaderEvent
+
+| Members            | Value                        |
+| ------------------ | ---------------------------- |
+| **`Unknown`**      | <code>'UNKNOWN'</code>       |
+| **`CardInserted`** | <code>'CARD_INSERTED'</code> |
+| **`CardRemoved`**  | <code>'CARD_REMOVED'</code>  |
+
+
+#### ReaderDisplayMessage
+
+| Members                                | Value                                              |
+| -------------------------------------- | -------------------------------------------------- |
+| **`CheckMobileDevice`**                | <code>'CHECK_MOBILE_DEVICE'</code>                 |
+| **`RetryCard`**                        | <code>'RETRY_CARD'</code>                          |
+| **`InsertCard`**                       | <code>'INSERT_CARD'</code>                         |
+| **`InsertOrSwipeCard`**                | <code>'INSERT_OR_SWIPE_CARD'</code>                |
+| **`SwipeCard`**                        | <code>'SWIPE_CARD'</code>                          |
+| **`RemoveCard`**                       | <code>'REMOVE_CARD'</code>                         |
+| **`MultipleContactlessCardsDetected`** | <code>'MULTIPLE_CONTACTLESS_CARDS_DETECTED'</code> |
+| **`TryAnotherReadMethod`**             | <code>'TRY_ANOTHER_READ_METHOD'</code>             |
+| **`TryAnotherCard`**                   | <code>'TRY_ANOTHER_CARD'</code>                    |
+| **`CardRemovedTooEarly`**              | <code>'CARD_REMOVED_TOO_EARLY'</code>              |
+
+
+#### ReaderInputOption
+
+| Members           | Value                       |
+| ----------------- | --------------------------- |
+| **`None`**        | <code>'NONE'</code>         |
+| **`Insert`**      | <code>'INSERT'</code>       |
+| **`Swipe`**       | <code>'SWIPE'</code>        |
+| **`Tap`**         | <code>'TAP'</code>          |
+| **`ManualEntry`** | <code>'MANUAL_ENTRY'</code> |
+
+
+#### PaymentStatus
+
+| Members               | Value                            |
+| --------------------- | -------------------------------- |
+| **`Unknown`**         | <code>'UNKNOWN'</code>           |
+| **`NotReady`**        | <code>'NOT_READY'</code>         |
+| **`Ready`**           | <code>'READY'</code>             |
+| **`WaitingForInput`** | <code>'WAITING_FOR_INPUT'</code> |
+| **`Processing`**      | <code>'PROCESSING'</code>        |
 
 </docgen-api>

package/android/build.gradle

@@ -7,7 +7,7 @@ ext {
     playServicesWalletVersion = project.hasProperty('playServicesWalletVersion') ? rootProject.ext.playServicesWalletVersion : '19.2.+'
     volleyVersion = project.hasProperty('volleyVersion') ? rootProject.ext.volleyVersion : '1.2.1'
     stripeterminalLocalmobileVersion = project.hasProperty('stripeterminalLocalmobileVersion') ? rootProject.ext.stripeterminalLocalmobileVersion : '3.5.+'
-    stripeterminalCoreVersion = project.hasProperty('stripeterminalCoreVersion') ? rootProject.ext.stripeterminalCoreVersion : '3.7.+'
+    stripeterminalCoreVersion = project.hasProperty('stripeterminalCoreVersion') ? rootProject.ext.stripeterminalCoreVersion : '3.8.+'
 }
 
 buildscript {