Conectarse a un lector

Conecta tu aplicación a un lector de Stripe Terminal.

Nota

Si aún no has elegido ningún lector, compara los lectores de Terminal disponibles y elige el que mejor se adapte a tus necesidades.

Los SDK de Stripe Terminal y la integración basada en el servidor cuentan con un lector de tarjetas simulado incorporado para que puedas desarrollar y probar tu aplicación sin tener que conectarla a un hardware físico. Ya sea que tengas una integración completa o que la estés desarrollando, utiliza el lector simulado para emular todos los flujos de Terminal de tu aplicación.

El lector simulado no proporciona una interfaz de usuario. Después de conectarte a él en tu aplicación, podrás ver que funciona cuando se realizan correctamente las llamadas al SDK o a la API de Stripe.

Los lectores simulados para SDK simulan automáticamente la presentación de la tarjeta según sea necesario. Para la integración basada en servidor, actualiza tu integración a simular presentación de tarjeta.

Para utilizar el lector simulado, llama a discoverReaders para buscar lectores, con la opción isSimulated en la DiscoveryConfiguration elegida establecida en true. Cuando discoverReaders devuelve un resultado, llama a connectReader para conectarte al lector simulado.

Cuando te conectas a un lector móvil, tu integración debe incluir el locationId en la configuración de conexión, incluso para el lector simulado. Como el lector simulado no se puede asociar con una ubicación real, proporciona en su lugar el simulacro de locationId del lector simulado.

ConnectReaderActivity.kt
Seleccionar un idiomaKotlin
Java
 No results
// Handler for a "Connect Reader" button
fun onConnect() {
    val config = BluetoothDiscoveryConfiguration(timeout = 0, isSimulated = true)

    Terminal.getInstance().discoverReaders(
        config,
        object : DiscoveryListener {
            override fun onUpdateDiscoveredReaders(readers: List<Reader>) {
                // Select the first reader here.
                val firstReader = readers.first()
                // Replace 'yourMobileReaderListener' with your actual MobileReaderListener implementation
                val mobileReaderListener = yourMobileReaderListener
                val autoReconnectOnUnexpectedDisconnect = true

                // When connecting to a physical reader, specify either the
                // same location as the last connection (selectedReader.location?.id) or a new location
                // of your user's choosing.
                //
                // Since the simulated reader isn't associated with a real location, we recommend
                // specifying its existing mock location.
                val connectionConfig = BluetoothConnectionConfiguration(
                    locationId = firstReader.location?.id.orEmpty(),
                    autoReconnectOnUnexpectedDisconnect = autoReconnectOnUnexpectedDisconnect
                    bluetoothReaderListener = mobileReaderListener
                )

                Terminal.getInstance().connectReader(
                    firstReader,
                    connectionConfig,
                    object : ReaderCallback {
                        override fun onSuccess(reader: Reader) {
                            // Placeholder for handling successful operation
                        }

                        override fun onFailure(e: TerminalException) {
                            // Placeholder for handling exception
                        }
                    }
                )
            }
        },
        object : Callback {
            override fun onSuccess() {
                // Placeholder for handling successful operation
            }

            override fun onFailure(e: TerminalException) {
                // Placeholder for handling exception
            }
        }
    )
}

Configuración del lector simulado

El lector simulado acepta una pequeña configuración, con lo que puedes probar diferentes flujos de la aplicación en tu punto de venta, por ejemplo: diferentes marcas de tarjeta o situaciones de error, como que se rechace un cobro. Para habilitar este comportamiento, usa el siguiente código antes de recolectar tu método de pago:

Próximos pasos

Has conectado tu aplicación al lector. A continuación, recoge tu primer pago de Stripe Terminal.

El nombre y el logotipo de BBPOS y Chipper™ son marcas comerciales o marcas registradas de BBPOS Limited en los Estados Unidos y/u otros países. El nombre y el logotipo de Verifone® son marcas comerciales o marcas registradas de Verifone en los Estados Unidos y/u otros países. El uso de las marcas comerciales no implica la aprobación por parte de BBPOS o Verifone.