Reader Discovery & Connection

The possible methods for discovering a reader. This is provided for convenience when working with SCPDiscoveryConfiguration objects.

Implement this protocol to handle a continually updating list of discovered readers. You must pass an SCPDiscoveryDelegate when calling -[SCPTerminal discoverReaders:delegate:completion:].

Protocol for classes to conform to that apply configuration options for discovering readers.

You should not implement this protocol yourself; instead, use one of the following:

• SCPBluetoothScanDiscoveryConfiguration
• SCPBluetoothProximityDiscoveryConfiguration
• SCPInternetDiscoveryConfiguration
• SCPLocalMobileDiscoveryConfiguration

Objects of those types get passed into the Terminal.shared.discoverReaders() method to control which devices get discovered, and how.

The Bluetooth Scan discovery method searches for Stripe Terminal’s Bluetooth-capable readers.

When discovering a reader using this method, the didUpdateDiscoveredReaders delegate method will be called multiple times as the Bluetooth scan proceeds.

Create instances of this class using a SCPBluetoothScanDiscoveryConfigurationBuilder.

Builder class for SCPBluetoothScanDiscoveryConfiguration

The Bluetooth Proximity discovery method searches for a subset of Stripe Terminal’s Bluetooth-capable readers.

If your app will be used in a busy environment with multiple iOS devices pairing to multiple available readers at the same time, we recommend using this discovery method.

After a reader has been discovered using this method, the LEDs located above the reader’s power button will start flashing multiple colors. After discovering the reader, your app should prompt the user to confirm that the reader is flashing, and require a user action (e.g. tapping a button) to connect to the reader.

When discovering a reader using this method, the didUpdateDiscoveredReaders delegate method will be called twice. It will be called for the first time when the reader is initially discovered. The reader’s LEDs will begin flashing. After a short delay, didUpdateDiscoveredReaders will be called a second time with an updated reader object, populated with additional info about the device, like its battery level.

Create instances of this class using a SCPBluetoothProximityDiscoveryConfigurationBuilder.

Builder for the Bluetooth Proximity discovery class.

Example usage:

[[[SCPBluetoothProximityDiscoveryConfigurationBuilder new] setSimulated:YES] build]

BluetoothProximityDiscoveryConfigurationBuilder().setSimulated(true).build()

The Internet discovery method searches for internet-connected readers, such as the Stripe S700 or the BBPOS WisePOS E.

When discovering a reader with this method didUpdateDiscoveredReaders will only be called once with a list of readers from /v1/terminal/readers. Note that this will include readers that are both online and offline.

Because the discovery process continues if connecting to a discovered reader fails, the SDK will refresh the list of SCPReaders and call didUpdateDiscoveredReaders with the results. For more details about failed connect calls, see -[SCPTerminal connectReader:connectionConfig:cancelable:completion:]

Create instances of this class using a SCPInternetDiscoveryConfigurationBuilder.

Builder class for SCPInternetDiscoveryConfiguration

Example usage:

[[[SCPInternetDiscoveryConfigurationBuilder new] setLocationId:@"tml_123"] build]

try InternetDiscoveryConfigurationBuilder().setLocationId("tml_123").build()

The Local Mobile discovery method searches for any readers built into the merchant device that are supported by Stripe Terminal. When discovering a reader with this method didUpdateDiscoveredReaders will only be called once with a list of discovered readers, if any. An error may be provided if a discovery attempt is made in an on a device without hardware support for the Apple Built-In reader or one running an unsupported version of iOS.

Create instances of this class using a SCPLocalMobileDiscoveryConfigurationBuilder.

Builder class for SCPLocalMobileDiscoveryConfiguration

Example usage:

[[[SCPLocalMobileDiscoveryConfigurationBuilder new] setSimulated:YES] build]

try LocalMobileDiscoveryConfigurationBuilder().setSimulated(true).build()

This class lets you define Bluetooth reader connection options.

An object of this class should get passed into Terminal.shared.connectBluetoothReader().

The CollectConfigurationBuilder is used to create a CollectConfiguration object.

This class lets you set options that define internet reader behavior throughout a given reader-to-SDK connection session.

Use this to build SCPInternetConnectionConfiguration objects.

This class lets you set options that define local mobile reader behavior throughout a given reader-to-SDK connection session.

A builder class for SCPLocalMobileConnectionConfiguration.

The possible reader connection statuses for the SDK.

Parameters to be used when calling Terminal.shared.listLocations() to list the Location objects associated with an account.

Builder class for SCPListLocationsParameters.

A Location is used to group readers in the Stripe Terminal ecosystem. The Location to which a reader is registered can control regional behavior for that particular reader.

You cannot create locations through the SDK. Instead, use the Stripe API from your backend to manage your account’s locations.

To fetch the Location objects associated with your account, call Terminal.shared.listLocations().

Represents the possible states of the location object for a discovered reader.

Holds address data associated with a given SCPLocation.

You cannot create SCPAddress objects from within the SDK. Instead, they will be returned as an address property on an SCPLocation object retrieved by the SDK.

Simulator specific configurations you can set to test your integration’s behavior in different scenarios. We recommend changing these properties during testing to ensure your app works as expected for different reader updates and for different presented cards.

Do not create new instances of this class. Instead, set the properties via SCPTerminal.shared.simulatorConfiguration.

Enum used to simulate various types of reader updates being available for a simulated bluetooth or local mobile reader.

Simulated Card objects can be used with the shared SCPSimulatorConfiguration to simulate different card brand and error cases with a simulated Reader.

Simulated Card objects are backed by one of Stripe’s test card numbers, which are hardcoded to provide certain behavior within Stripe’s backend. The Terminal SDK provides an SCPSimulatedCardType enum that automatically maps to the card numbers for convenience.

Enum used to simulate various types of cards and error cases.