SCPDiscoveryMethod

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.

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.

The Internet discovery method searches for internet-connected readers, such as the Verifone P400 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:completion:]

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.