# Lesegerät registrieren

Registrieren Sie Ihre Lesegeräte bei einem Standort.

Sie müssen Ihr Lesegerät bei einem Standort registrieren, um Zahlungen annehmen zu können. Das Verfahren zur Registrierung des Lesegeräts bei einem Standort unterscheidet sich je nachdem, ob es sich um ein [intelligentes Lesegerät](https://docs.stripe.com/terminal/smart-readers.md) oder ein [mobiles Lesegerät](https://docs.stripe.com/terminal/mobile-readers.md) handelt.

Jede [Benutzerrolle](https://docs.stripe.com/get-started/account/teams/roles.md) mit Schreibberechtigungen kann Lesegeräte registrieren.

## Intelligente Lesegeräte

Sie können intelligente Lesegeräte auf drei Arten registrieren:

- Registrierungscode
- Seriennummer
- Bestellnummer

### Registrierungscode

Für diese Methode müssen Sie einen Kopplungscode (auch als Registrierungscode bezeichnet) auf dem Lesegerät generieren. Wenn ein Lesegerät nicht registriert ist, wird automatisch ein Kopplungscode auf dem Bildschirm angezeigt, wenn Sie es auspacken. Wenn dies nicht der Fall ist oder Sie ein Lesegerät erneut registrieren müssen, können Sie über die [Admin-Einstellungen](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md#settings) einen neuen Kopplungscode generieren. Nachdem Sie den Kopplungscode generiert haben, können Sie ihn im Dashboard oder in der API eingeben, um das Lesegerät zu registrieren.

#### Dashboard

1. Klicken Sie auf der Registerkarte **Lesegeräte** auf der Seite [Terminal-Lesegeräte](https://dashboard.stripe.com/terminal/readers) auf **Lesegeräte registrieren**.
1. Geben Sie den Kopplungscode auf dem Lesegerät ein und klicken Sie auf **Weiter**.
1. Geben Sie einen Namen für das Lesegerät an.
1. Weisen Sie einem Standort zu oder erstellen Sie einen neuen.
1. Bestätigen Sie die Angaben und klicken Sie auf **Registrieren**.

#### API

Verwenden Sie die [Reader API](https://docs.stripe.com/api/terminal/readers/create.md), um ein Lesegerät mit einem Kopplungscode zu registrieren.

```curl
curl https://api.stripe.com/v1/terminal/readers \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d registration_code={{READER_REGISTRATION_CODE}} \
  --data-urlencode "label=Alice's reader" \
  -d "location={{TERMINALLOCATION_ID}}"
```

### Seriennummer

Sie können Lesegräte anhand ihrer Seriennummer registrieren. Bei dieser Methode muss das Lesegerät nicht physisch registriert werden, sodass Sie es sofort nach dem Auspacken verwenden können. Mit dieser Methode können Sie das Lesegerät auch neu registrieren, ohne dass das Lesegerät physisch einen Kopplungscode generieren muss.

Sie können die Seriennummer auf folgende Weise finden:

- Über die Hardware-Bestellung auf der Registerkarte [Hardware-Bestellungen](https://dashboard.stripe.com/terminal/hardware_orders)
- Auf dem Lesegerät selbst (auf dem Karton und auf der Rückseite des Lesegeräts)
- Wenn das Lesegerät bereits registriert ist, auf der Seite mit den Details zum Lesegerät im Dashboard oder in der [Reader API](https://docs.stripe.com/api/terminal/readers.md)

> Diese Methode funktioniert nur für Lesegeräte, die nach Konto geordnet wurden. Bei Plattformen muss die Plattform oder das Unterkonto die Bestellung aufgegeben haben, um sie einem Unterkonto zuzuordnen.

> Mit dieser Methode können Sie bis zu 10 Lesegeräte gleichzeitig registrieren.

#### Dashboard

Nachdem Sie die Seriennummer gefunden haben, können Sie das Lesegerät über den Registrierungsablauf im Dashboard registrieren.

1. Klicken Sie auf der Seite [Terminal-Lesegeräte](https://dashboard.stripe.com/terminal/readers) auf **Lesegerät registrieren**.
1. Geben Sie die Seriennummer ein und klicken Sie auf **Weiter**. Um mehrere Geräte gleichzeitig zu registrieren, können Sie mehrere Seriennummern durch Kommas getrennt eingeben.
1. Wählen Sie optional einen Namen für das Lesegerät aus.
1. Wenn Sie bereits einen Standort erstellt haben, wählen Sie den neuen Standort des Lesegeräts aus. Andernfalls erstellen Sie einen Standort, indem Sie auf **+ Neu hinzufügen** klicken.
1. Klicken Sie auf **Registrieren**, um die Registrierung Ihres Lesegeräts abzuschließen.

### Bestellnummer

> Diese Methode funktioniert nur für Lesegeräte, die über das Konto (oder eines der Unterkonten) bestellt wurden. Wenn das Lesegerät nicht mit einer Bestellung über dieses Konto verknüpft ist, funktioniert diese Methode nicht.

#### Dashboard

Im Dashboard können Sie Lesegeräte nach der Bestellnummer auf zwei Arten registrieren:

- Über die Bestellung selbst
- Durch Eingabe der Bestellnummer während des Registrierungsvorgangs

#### Über die Bestellung

1. Auf der Seite [Hardware-Bestellungen](https://dashboard.stripe.com/terminal/hardware_orders) finden Sie eine Bestellung mit dem Status entweder `shipped` oder `delivered`. Klicken Sie auf das Überlaufmenü (⋯) am Ende der Zeile und dann auf **Registrieren**.
1. Wählen Sie auf der Seite „Lesegerät registrieren“ ein oder mehrere Lesegeräte in der Hardware-Bestellung aus, die Sie registrieren möchten, und klicken Sie dann auf **Registrieren**.
1. Wählen Sie optional einen Namen für das Lesegerät. Wenn Sie mehrere Lesegeräte ausgewählt haben, dient der Name als Präfix und wir benennen die Lesegeräte der Reihe nach (zum Beispiel legen wir für eine bestimmte Eingabe von „Testlesegerät“ die Bezeichnungen „Testlesegerät&nbsp;1“, „Testlesegerät&nbsp;2“ usw. fest).
1. Wenn Sie bereits einen Standort erstellt haben, wählen Sie den neuen Standort des Lesegeräts aus. Andernfalls erstellen Sie einen Standort, indem Sie auf **+ Neu hinzufügen** klicken.
1. Klicken Sie auf **Registrieren**, um die Registrierung Ihrer Lesegeräte abzuschließen.

#### Registrierungsvorgang

1. Klicken Sie auf der Seite [Terminal-Lesegeräte](https://dashboard.stripe.com/terminal/readers) auf **Lesegerät registrieren**.
1. Geben Sie die Bestellnummer ein und klicken Sie auf **Weiter**. Wenn sich in der Bestellung registrierbare Lesegeräte befinden, fahren Sie fort, indem Sie auf **Registrieren** klicken.
1. Wählen Sie auf der Seite **Lesegerät registrieren** ein oder mehrere Lesegerät aus der Hardware-Reihenfolge aus, die Sie registrieren möchten, und klicken Sie dann auf **Registrieren**.
1. Wählen Sie optional einen Namen für das Lesegerät aus. Wenn Sie mehrere Lesegeräte ausgewählt haben, dient der Name als Präfix, und die Lesegeräte werden nacheinander benannt (zum Beispiel legen wir für eine bestimmte Eingabe von „Testlesegerät“ die Bezeichnungen „Testlesegerät 1“, „Testelesegerät 2“ usw. fest).
1. Wenn Sie bereits einen Standort erstellt haben, wählen Sie den neuen Standort des Lesegeräts aus. Andernfalls erstellen Sie einen Standort, indem Sie auf **+ Neu hinzufügen** klicken.
1. Klicken Sie auf **Registrieren**, um die Registrierung Ihrer Lesegeräte abzuschließen.

## Mobile Lesegeräte

#### iOS

Registrieren Sie die mobilen Lesegeräte ([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) und [BBPOS WisePad 3](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader)) während der Verbindungsherstellung bei einem Standort, indem Sie die `locationId` in Ihrer `BluetoothConnectionConfiguration` angeben. Wenn Sie dies bevorzugen, können Sie erkannte Lesegeräte bei dem zuletzt verwendeten Standort registrieren, indem Sie die `reader.locationId` übergeben.

#### 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

Registrieren Sie die mobilen Lesegeräte ([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) und [BBPOS WisePad 3](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader)) während der Verbindungsherstellung bei einem Standort, indem Sie die `locationId` in Ihrer `BluetoothConnectionConfiguration` angeben. Wenn Sie dies bevorzugen, können Sie erkannte Lesegeräte bei dem zuletzt verwendeten Standort registrieren, indem Sie die `reader.locationId` übergeben.

#### 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

Registrieren Sie mobile Lesegeräte ([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) und [BBPOS WisePad 3](https://docs.stripe.com/terminal/payments/connect-reader.md?reader-type=bluetooth#connect-reader)) während der Herstellung der Verbindung des Lesegeräts bei einem Standort, indem Sie die `locationId` in Ihrem `connectReader`-Aufruf angeben. Wenn Sie möchten, können Sie das Lesegerät beim zuletzt verwendeten Standort registrieren, indem Sie die `reader.locationId` von einem erkannten Lesegerät übergeben.

```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);
};
```