# Enregistrer des lecteurs Enregistrez vos lecteurs dans un emplacement. Vous devez enregistrer votre lecteur dans un emplacement afin de pouvoir accepter des paiements. Le processus d’enregistrement de votre lecteur diffère selon qu’il s’agit d’un [lecteur intelligent](https://docs.stripe.com/terminal/smart-readers.md) ou d’un [lecteur mobile](https://docs.stripe.com/terminal/mobile-readers.md). Tous les [rôles utilisateur](https://docs.stripe.com/get-started/account/teams/roles.md) disposant d’autorisations en écriture peuvent enregistrer des lecteurs. ## Lecteurs intelligents Vous pouvez enregistrer des lecteurs intelligents de trois manières différentes : - Code d’inscription - Numéro de série - Numéro de commande ### Code d’inscription Pour cette méthode, vous devez générer un code de jumelage (également appelé code d’enregistrement) sur le lecteur. Si un lecteur n’est pas enregistré, un code de jumelage s’affiche automatiquement à l’écran lors du déballage. Si ce n’est pas le cas, ou si vous devez réenregistrer un lecteur, vous pouvez générer un nouveau code de jumelage via les [paramètres d’administration](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md#settings). Après avoir généré le code de jumelage, vous pouvez le saisir dans le Dashboard ou via l’API pour enregistrer le lecteur. #### Dashboard 1. Dans l’onglet **Lecteurs** de la page [Lecteurs Terminal](https://dashboard.stripe.com/terminal/readers), cliquez sur **Enregistrer le lecteur**. 1. Saisissez le code d’association sur le lecteur et cliquez sur **Suivant**. 1. Donnez un nom au lecteur. 1. Affectez le lecteur à un emplacement ou créez-en un nouveau. 1. Confirmez les détails et cliquez sur **Enregistrer**. #### API Utilisez l’[API Reader](https://docs.stripe.com/api/terminal/readers/create.md) pour enregistrer un lecteur avec un code d’association. ```curl curl https://api.stripe.com/v1/terminal/readers \ -u "<>:" \ -d registration_code={{READER_REGISTRATION_CODE}} \ --data-urlencode "label=Alice's reader" \ -d "location={{TERMINALLOCATION_ID}}" ``` ### Numéro de série Vous pouvez enregistrer des lecteurs à l’aide de leur numéro de série. Pour cette méthode, il n’est pas nécessaire que quelqu’un soit physiquement en possession du lecteur pour l’enregistrer. Ainsi, le lecteur est immédiatement prêt à l’emploi. Cette méthode vous permet également de réenregistrer le lecteur et de générer un code d’association, sans être physiquement en possession du lecteur. Vous pouvez trouver le numéro de série de la manière suivante : - À partir de la commande de matériel, dans l’onglet [Commandes de matériel](https://dashboard.stripe.com/terminal/hardware_orders) - Sur le lecteur lui-même (sur la boîte et au dos du lecteur) - Si le lecteur est déjà enregistré, à partir de la page relative aux informations sur le lecteur dans le Dashboard ou de l’[API Reader](https://docs.stripe.com/api/terminal/readers.md) > Cette méthode ne fonctionne que pour les lecteurs qui ont été commandés par le compte. En ce qui concerne les plateformes, la commande doit être passée par la plateforme ou le sous-compte pour l’enregistrer dans un sous-compte. > Cette méthode vous permet d’enregistrer jusqu’à 10 lecteurs à la fois. #### Dashboard Après avoir trouvé le numéro de série, vous pouvez enregistrer le lecteur via le flux d’enregistrement dans le Dashboard. 1. Sur la page [Lecteurs Terminal](https://dashboard.stripe.com/terminal/readers), cliquez sur **Enregistrer un lecteur**. 1. Saisissez le numéro de série et cliquez sur **Suivant**. Pour enregistrer plusieurs appareils à la fois, vous pouvez saisir plusieurs numéros de série, séparés par des virgules. 1. Vous pouvez facultativement choisir un nom pour le lecteur. 1. Si vous avez déjà créé un emplacement, sélectionnez le nouvel emplacement du lecteur. Sinon, créez-en un en cliquant sur **+ Ajouter un emplacement**. 1. Cliquez sur **Enregistrer** pour terminer l’enregistrement de votre lecteur. ### Numéro de commande > Cette méthode ne fonctionne que pour les lecteurs qui ont été commandés par ce compte (ou l’un de ses sous-comptes). Si le lecteur n’est pas associé à une commande de ce compte, cette méthode ne fonctionnera pas. #### Dashboard Dans le Dashboard, vous pouvez enregistrer des lecteurs par le numéro de commande de deux manières différentes : - À partir de la commande elle-même - Saisie du numéro de commande au cours du flux d’enregistrement #### À partir de la commande 1. Sur la page [Commandes de matériel](https://dashboard.stripe.com/terminal/hardware_orders), trouvez une commande dont le statut est `shipped` ou `delivered`. Cliquez sur le menu déroulant (⋯) à la fin de la ligne, puis cliquez sur **Enregistrer**. 1. Sur la page Enregistrer des lecteurs, sélectionnez un ou plusieurs lecteurs dans la commande de matériel à enregistrer, puis cliquez sur **Enregistrer**. 1. Vous pouvez facultativement choisir un nom pour le lecteur. Si vous avez sélectionné plusieurs lecteurs, le nom sert de préfixe et nous nommons les lecteurs de manière séquentielle (par exemple, pour une entrée donnée « Lecteur de test », nous nommons les lecteurs « Lecteur de test 1 », « Lecteur de test 2 », et ainsi de suite). 1. Si vous avez déjà créé un emplacement, sélectionnez le nouvel emplacement du lecteur. Sinon, créez-en un en cliquant sur **+ Ajouter un emplacement**. 1. Cliquez sur **Enregistrer** pour terminer l’enregistrement de vos lecteurs. #### Flux d’enregistrement 1. Sur la page [Lecteurs Terminal](https://dashboard.stripe.com/terminal/readers), cliquez sur **Enregistrer un lecteur**. 1. Saisissez le numéro de commande et cliquez sur **Suivant**. Si la commande contient des lecteurs enregistrables, continuez en cliquant sur **Enregistrer**. 1. Sur la page **Enregistrer des lecteurs**, sélectionnez un ou plusieurs lecteurs dans la commande de matériel à enregistrer, puis cliquez sur **Enregistrer**. 1. Vous pouvez facultativement choisir un nom pour le lecteur. Si vous avez sélectionné plusieurs lecteurs, le nom sert de préfixe et nous nommons les lecteurs de manière séquentielle (par exemple, pour une entrée donnée « Lecteur de test », nous nommons les lecteurs « Lecteur de test 1 », « Lecteur de test 2 », et ainsi de suite). 1. Si vous avez déjà créé un emplacement, sélectionnez le nouvel emplacement du lecteur. Sinon, créez-en un en cliquant sur **+ Ajouter un emplacement**. 1. Cliquez sur **Enregistrer** pour terminer l’enregistrement de vos lecteurs. ## Lecteurs mobiles #### iOS Enregistrez les lecteurs mobiles ([Stripe Reader M2](https://docs.stripe.com/terminal/readers/stripe-m2.md), [BBPOS Chipper 2X BT](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader) et [BBPOS WisePad 3](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader)) à un emplacement lors de la connexion au lecteur en spécifiant le `locationId` dans votre `BluetoothConnectionConfiguration`. Si vous préférez, vous pouvez enregistrer le lecteur sur le dernier emplacement utilisé en passant le `reader.locationId` d’un lecteur découvert. #### Swift ```swift // Call `connectReader` with the selected reader and a connection config // to register to a location as set by your app. let connectionConfig: BluetoothConnectionConfiguration do { connectionConfig = try BluetoothConnectionConfigurationBuilder(delegate: yourMobileReaderDelegate, locationId: ""{{LOCATION_ID}}"") .build() } catch { // Handle the error building the connection configuration return } Terminal.shared.connectReader(selectedReader, connectionConfig: connectionConfig) { reader, error in if let reader = reader { print("Successfully connected to reader: \(reader)") } else if let error = error { print("connectReader failed: \(error)") } } ``` #### Android Enregistrez les lecteurs mobiles ([Stripe Reader M2](https://docs.stripe.com/terminal/readers/stripe-m2.md), [BBPOS Chipper 2X BT](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader) et [BBPOS WisePad 3](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader)) à un emplacement lors de la connexion au lecteur en spécifiant le `locationId` dans votre `BluetoothConnectionConfiguration`. Si vous préférez, vous pouvez enregistrer le lecteur sur le dernier emplacement utilisé en passant le `reader.locationId` d’un lecteur découvert. #### Kotlin ```kotlin // Implement your MobileReaderListener val mobileReaderListener = yourMobileReaderListener val autoReconnectOnUnexpectedDisconnect = true val connectionConfig = BluetoothConnectionConfiguration( ""{{LOCATION_ID}}"", autoReconnectOnUnexpectedDisconnect, mobileReaderListener ) Terminal.getInstance().connectReader( selectedReader, connectionConfig, object : ReaderCallback { override fun onSuccess(reader: Reader) { // Placeholder for handling successful operation } override fun onFailure(e: TerminalException) { // Placeholder for handling exception } } ) ``` #### React Native Enregistrez les lecteurs mobiles ([Stripe Reader M2](https://docs.stripe.com/terminal/readers/stripe-m2.md), [BBPOS Chipper 2X BT](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader) et [BBPOS WisePad 3](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader)) à un emplacement lors de la connexion au lecteur en précisant le `locationId` dans votre appel à `connectReader`. Si vous préférez, vous pouvez enregistrer le lecteur sur le dernier emplacement utilisé en transmettant le `reader.locationId` à partir d’un lecteur détecté. ```js const handleConnectBluetoothReader = async (id) => { const { reader, error } = await connectReader({ discoveryMethod: 'bluetoothScan', reader: selectedReader, locationId: {{LOCATION_ID}}, }); if (error) { console.log('connectReader error', error); return; } console.log('Reader connected successfully', reader); }; ```