Se connecter à un lecteur

Avant de pouvoir connecter votre application à un lecteur intelligent, vous devez enregistrer le lecteur sur votre compte.

Après avoir enregistré le lecteur sur votre compte, recherchez les lecteurs précédemment enregistrés afin de vous connecter à votre application de point de vente avec discoverReaders en utilisant InternetDiscoveryConfiguration.

Vous pouvez affiner votre recherche en spécifiant l’emplacement location dans lequel vous avez enregistré le lecteur lors de l’étape précédente.

import StripeTerminal

class DiscoverReadersViewController: UIViewController, DiscoveryDelegate {
  func discoverReadersAction() throws {
      let config = try InternetDiscoveryConfigurationBuilder()
                          .setLocationId(
"{{LOCATION_ID}}")
                          .build()
      // In addition to Terminal's completion block methods, Swift async alternatives are available.
      // See our Example app for usage examples: https://github.com/stripe/stripe-terminal-ios/tree/master/Example
      self.discoverCancelable = Terminal.shared.discoverReaders(config, delegate: self) { error in
          if let error = error {
              print("discoverReaders failed: \(error)")
          } else {
              print("discoverReaders succeeded")
          }
      }
  }
}

Lors de la découverte de lecteurs intelligents, la méthode DiscoveryDelegate.didUpdateDiscoveredReaders n’est sollicitée qu’une fois par appel à discoverReaders. didUpdateDiscoveredReaders renvoie une liste vide de lecteurs lorsqu’aucun lecteur n’est enregistré ou qu’aucun lecteur n’est associé à l’emplacement donné. Si vous sollicitez ultérieurement discoverReaders pour rafraîchir la liste, vous devez au préalable annuler l’appel précédent avec le Cancelable retourné par discoverReaders.

InternetDiscoveryConfiguration prend en charge une valeur facultative timeout pour la détection des lecteurs en ligne. Cela permet d’accélérer la détection des lecteurs hors ligne en cas d’échec de la tentative en ligne.

Pour connecter votre application de point de vente à un lecteur, appelez connectReader avec le lecteur sélectionné en utilisant la fonction InternetConnectionConfiguration.

let config: InternetConnectionConfiguration
do {
    config = try InternetConnectionConfigurationBuilder(delegate: yourInternetReaderDelegate)
        .build()
} catch {
    // Handle error building the connection configuration
    return
}

Terminal.shared.connectReader(selectedReader, connectionConfig: config) { reader, error in
    if let reader = reader {
        print("Successfully connected to reader: \(reader)")
    } else if let error = error {
        print("connectReader failed: \(error)")
    }
}

Connexions multiples

Une seule instance du SDK Stripe Terminal peut se connecter à un lecteur à la fois. Par défaut, lorsque vous appelez connectReader à partir d’une autre application, la connexion entrante remplace la connexion existante entre le SDK et le lecteur, et le SDK précédemment connecté se déconnecte du lecteur. La méthode connectReader utilise un objet Configuration avec une propriété failIfInUse dont la valeur par défaut est false. Lorsque votre application définit failIfInUse sur true, l’appel connectReader a un comportement alternatif où la connexion entrante échoue lorsque le lecteur est au milieu d’un appel collectPaymentMethod ou confirmPaymentIntent lancé par un SDK. Si le lecteur est connecté à un SDK mais qu’il est inactif (il affiche l’écran d’accueil avant l’appel de collectPaymentMethod), le paramétrage de failIfInUse ne modifie pas le comportement de la connexion. La demande de connexion entrante peut toujours interrompre la connexion SDK-lecteur existante.

let internetReaderDelegate = yourInternetReaderDelegate // implement your internetReaderDelegate

let config: InternetConnectionConfiguration
do {
    config = try InternetConnectionConfigurationBuilder(delegate: internetReaderDelegate)
          .setFailIfInUse(true)
          .build()
} catch {
    // Handle error building the connection configuration
    return
}
Terminal.shared.connectReader(selectedReader, connectionConfig: config, completion: { reader, error in
    // ...
})

Pour perturber le moins possible l’expérience de connexion dans les environnements à plusieurs lecteurs, nous vous recommandons de définir la valeur failIfInUse sur true lors de la première tentative de connexion de votre application. Ensuite, permettez à vos utilisateurs de réessayer la connexion avec failIfInUse sur false si la connexion échoue la première fois.

Avec cette configuration, vos utilisateurs ne peuvent pas interrompre accidentellement une transaction en se connectant par inadvertance à un lecteur en cours d’utilisation, mais peuvent toujours se connecter si nécessaire.

Gérer les déconnexions

Votre application doit mettre en place le rappel reader(_, didDisconnect:) afin de remédier à toute déconnexion du lecteur. Lors de la mise en place de ce rappel, affichez une interface utilisateur qui informe l’utilisateur du que le lecteur est déconnecté. Vous pouvez appeler discoverReaders pour rechercher des lecteurs et initier une reconnexion.

Votre application peut tenter de se reconnecter automatiquement au lecteur déconnecté ou afficher une interface utilisateur qui invite l’utilisateur à se reconnecter à un autre lecteur.

Le lecteur peut se déconnecter de votre application s’il perd la connexion au réseau. Pour simuler une déconnexion inattendue, éteignez le lecteur.

import StripeTerminal

class ReaderViewController: UIViewController, InternetReaderDelegate {
    override func viewDidLoad() {
        super.viewDidLoad()
        // Set the reader delegate when connecting to a reader
    }

    // ...



    func reader(_ reader: Reader, didDisconnect reason: DisconnectReason) {
        // Consider displaying a UI to notify the user and start rediscovering readers
    }
}

Reconnexion automatique

Stripe Terminal ne se reconnecte pas automatiquement à un lecteur au démarrage de votre application. Vous pouvez créer un flux de reconnexion en enregistrant les ID de lecteur et en essayant de vous connecter à un lecteur connu au démarrage.

1. Lorsque vous vous connectez à un lecteur, enregistrez son numéro de série dans un emplacement de stockage persistant, comme l’API UserDefaults (iOS).
2. Au lancement de votre application, vérifiez si un numéro de série enregistré se trouve dans cet emplacement persistant. Si vous en trouvez un, appelez la méthode discoverReaders afin que votre application puisse essayer de retrouver le lecteur.
3. Si le numéro de série enregistré correspond à l’un des lecteurs détectés, essayez de vous connecter à ce lecteur à l’aide de l’objet Reader correspondant renvoyé par l’appel à discoverReaders. Si le lecteur en question est introuvable, mettez fin au processus de recherche.

Au cours du processus de détection et de connexion, vous pouvez afficher un message d’interface utilisateur indiquant qu’une reconnexion automatique est en cours.