Connettere un lettore

Connetti l'applicazione a un lettore Stripe Terminal.

Nota

Se non hai ancora scelto un lettore, confronta i lettori Terminal disponibili e scegli quello più adatto alle tue esigenze.

Gli SDK di Stripe Terminal e l’integrazione basata su server sono dotati di un lettore di carte simulato integrato, quindi puoi sviluppare e testare l’app senza connetterti all’hardware fisico. Se l’integrazione è completa o la stai ancora sviluppando, utilizza il lettore simulato per emulare tutti i flussi di Terminal nell’app.

Il lettore simulato non fornisce una interfaccia utente. Dopo aver effettuato la connessione nella tua app, la conferma del corretto funzionamento avviene quando le chiamate all’SDK o all’API di Stripe vanno a buon fine.

I lettori simulati per gli SDK simulano automaticamente la presentazione delle carte in base alle esigenze. Per l’integrazione basata su server, aggiorna l’integrazione per simulare la presentazione della carta.

Per utilizzare il lettore simulato, chiama discoverReaders per cercare i lettori, con l’opzione isSimulated nella DiscoveryConfiguration scelta impostata su true. Quando discoverReaders restituisce un risultato, chiama connectReader per connetterti al lettore simulato.

Quando ti connetti a un lettore mobile, la tua integrazione deve includere il parametro locationId nella configurazione della connessione, anche per il lettore simulato. Dato che il lettore simulato non può essere associato a una posizione reale, fornisci invece il parametro locationId fittizio del lettore simulato.

ConnectReaderActivity.kt
Seleziona una linguaKotlin
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
            }
        }
    )
}

Configurazione lettore simulato

Puoi configurare il lettore simulato per testare vari flussi nella tua applicazione POS, ad esempio circuiti carta diversi o scenari di errore come un addebito rifiutato. Per attivare questo comportamento, utilizza il codice seguente prima di acquisire il metodo di pagamento:

Passaggi successivi

Hai connesso la tua applicazione al lettore. Poi riscuoti il tuo primo pagamento Stripe Terminal.

Il nome e il logo BBPOS e Chipper™ sono marchi o marchi registrati di BBPOS Limited negli Stati Uniti e/o in altri paesi. Il nome e il logo Verifone® sono marchi o marchi registrati di Verifone negli Stati Uniti e/o in altri paesi. L’uso dei marchi non comporta alcun avallo da parte di BBPOS o Verifone.