Conectarse a un lector

TTPA opera en un proceso dedicado para hacer que las transacciones sean más seguras. En este proceso, se crea una segunda instancia de tu Application. Para evitar errores inesperados causados por la ejecución de tu código en este proceso, puedes omitir la inicialización en tu Application en este proceso marcando TapToPay.isInTapToPayProcess().

// Substitute with your application name, and remember to keep it the same as your AndroidManifest.xml
class StripeTerminalApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        // Skip initialization if running in the TTPA process.
        if (TapToPay.isInTapToPayProcess()) return

        // For example, this will be skipped.
        TerminalApplicationDelegate.onCreate(this)
    }
}

Utiliza el método discoverReaders para determinar el soporte de hardware para Tap to Pay en el dispositivo Android. discoverReaders verifica los siguientes requisitos:

• El dispositivo contiene una antena y un conjunto de chips NFC en funcionamiento.
• El dispositivo tiene un almacén de claves respaldado por hardware.
• El dispositivo ejecuta una versión actual de Android (Android 11 o superior).
• Para la versión no simulada del lector Tap to Pay, la aplicación no se puede depurar.

Tu aplicación debe estar en primer plano para que el servicio del lector Tap to Pay se inicie correctamente.

Si la aplicación se ejecuta en un dispositivo que no cumple con los requisitos anteriores, la devolución de llamada onFailure regresa con una TerminalException que contiene un TerminalErrorCode y contexto adicional. Los fallos en esta etapa no puede procesarlos el usuario final.

El uso de la versión de producción no simulada del lector Tap to Pay con aplicaciones procesables no es compatible por razones de seguridad y cumplimiento de la normativa. Para probar tu integración con el lector Tap to Pay en Android, establece TapToPayDiscoveryConfiguration.isSimulated en true durante el descubrimiento del lector. Debes establecer este valor en false en la versión de liberación de tu aplicación.

var discoverCancelable: Cancelable? = null

fun onDiscoverReaders() {
    val isApplicationDebuggable = 0 != applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE
    val config = TapToPayDiscoveryConfiguration(isSimulated = isApplicationDebuggable)

    // Save this cancelable to an instance variable
    discoverCancelable = Terminal.getInstance().discoverReaders(
        config,
        object : DiscoveryListener {
            override fun onUpdateDiscoveredReaders(readers: List<Reader>) {
                // Automatically connect to supported mobile readers
            }
        },
        object : Callback {
            override fun onSuccess() {
                // Placeholder for handling successful operation
            }

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

override fun onStop() {
    super.onStop()

    // If you're leaving the activity or fragment without selecting a reader,
    // make sure you cancel the discovery process or the SDK will be stuck in
    // a discover readers phase
    discoverCancelable?.cancel(
        object : Callback {
            override fun onSuccess() {
                // Placeholder for handling successful operation
            }

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

Para comprobar si un dispositivo cumple con los requisitos de hardware y sistema operativo de Tap to Pay en tiempo de ejecución, utiliza la función Terminal.supportsReadersOfType. Como parte de la inicialización del SDK de Terminal, esta función requiere que tu usuario final acepte solicitudes de permiso para acceder a la ubicación y al Bluetooth. Esta función tarda aproximadamente 10 milisegundos en ejecutarse en la mayoría de los dispositivos.

Para aceptar pagos de Tap to Pay, proporciona el lector detectado del paso anterior al método connectReader.

connectReader verifica los siguientes requisitos:

• El dispositivo tiene una conexión estable a Internet.
• El dispositivo no está rooteado y el gestor de arranque del dispositivo está bloqueado y sin cambios.
• El dispositivo utiliza los servicios de Google Móvil.
• El dispositivo ejecuta una versión actual de Android (Android 11 o superior).
• La aplicación utiliza una versión compatible del SDK de Tap to Pay (actualmente 2.20.0 o superior).

Si tu aplicación se ejecuta en un dispositivo que no cumple con los requisitos anteriores, la devolución de llamada onFailure’ regresa con una TerminalException que contiene un TerminalErrorCode y contexto adicional. El usuario final puede tomar medidas en algunos de los motivos de error. Por ejemplo:

• STRIPE_API_CONNECTION_ERROR: el usuario puede conectarse a una fuente de Internet estable.
• TAP_TO_PAY_UNSUPPORTED_ANDROID_VERSION: el usuario puede actualizar su sistema operativo si hay una actualización disponible del fabricante del dispositivo.

Debes registrar tu lector en una ubicación tras la conexión. Para hacerlo, crea y usa un TapToPayConnectionConfiguration con el locationId establecido en el ID de ubicación relevante al conectar.

val tapToPayReaderListener = yourTapToPayReaderListener
val autoReconnectOnUnexpectedDisconnect = true

val config = TapToPayConnectionConfiguration(
  
"{{LOCATION_ID}}",
  autoReconnectOnUnexpectedDisconnect,
  tapToPayReaderListener
),
Terminal.getInstance().connectReader(
  firstReader,
  config,
  object : ReaderCallback {
      override fun onSuccess(reader: Reader) {
          // Placeholder for handling successful operation
      }

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