# 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**.
2. Geben Sie den Kopplungscode auf dem Lesegerät ein und klicken Sie auf **Weiter**.
3. Geben Sie einen Namen für das Lesegerät an.
4. Weisen Sie einem Standort zu oder erstellen Sie einen neuen.
5. 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.

> Mit der Registrierung per Seriennummer kann kein Lesegerät übertragen werden, das bei einem nicht verknüpften Stripe-Konto registriert ist. Um das Lesegerät für dieses Konto zu registrieren, generieren Sie einen Registrierungscode auf dem Lesegerät und nutzen Sie den Ablauf [Registrierungscode](https://docs.stripe.com/terminal/fleet/register-readers.md#registration-code), der die erneute Registrierung eines Lesegeräts unterstützt.

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)

#### Nutzungsvoraussetzungen

- Sie können ein Lesegerät nicht bei einem Plattformkonto registrieren, wenn die Bestellung direkt über ein [verbundenes Konto](https://docs.stripe.com/connect.md) aufgegeben wurde, für das Ihre Plattform keine [Plattformsteuerungen](https://docs.stripe.com/connect/platform-controls-for-stripe-dashboard-accounts.md) besitzt.
- Wenn die Plattform die Bestellung aufgegeben hat, können verbundene Konten das Lesegerät nicht direkt selbst für ihr eigenes Konto registrieren. Die Plattform muss das Lesegerät im Namen des verbundenen Kontos für das verbundene Konto registrieren. Verwenden Sie dazu den [Header Stripe-Account](https://docs.stripe.com/connect/authentication.md#stripe-account-header) oder die Funktion [Dashboard anzeigen als](https://docs.stripe.com/connect/dashboard/managing-individual-accounts.md#view-the-dashboard-as-a-connected-account).

> 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**.
2. 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.
3. Wählen Sie optional einen Namen für das Lesegerät aus.
4. 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.
5. 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**.
   - Wenn Ihrer Bestellung keine Seriennummern zugewiesen wurden, öffnet ein Klick auf **Registrieren** den Prozess zur Vorabregistrierung. Erfahren Sie mehr über die [Vorabregistrierung von Lesegeräten bei Bestellung](https://docs.stripe.com/terminal/fleet/register-readers.md#pre-register-readers-when-ordering).
   - Wenn Ihrer Bestellung Seriennummern zugewiesen wurden, öffnet ein Klick auf **Registrieren** die Seite **Lesegeräte registrieren**. Fahren Sie mit den folgenden Schritten fort.
2. 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**.
3. 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).
4. 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.
5. Klicken Sie auf **Registrieren**, um die Registrierung Ihrer Lesegeräte abzuschließen.

#### Lesegeräte bei der Bestellung vorab registrieren

Wenn Sie Terminal-Hardware bestellen, können Sie vorab einen Standort für Ihre Lesegeräte auswählen. Stripe registriert jedes Lesegerät automatisch an diesem Standort, wenn Ihre Bestellung ausgeführt wird und Seriennummern zugewiesen werden.

##### Einschränkungen

- Jede Bestellung kann Lesegeräte nur für einen Standort vorab registrieren. Um Lesegeräte aus einer einzigen Bestellung auf mehrere Standorte zu verteilen, verwenden Sie die Seriennummer des Lesegeräts, nachdem Ihrer Bestellung Seriennummern zugewiesen wurden.
- Die Vorabregistrierung wird nicht kontenübergreifend unterstützt. Plattformkonten können Lesegeräte nicht vorab für den Standort eines verbundenen Kontos registrieren.

#### Registrierungsvorgang

1. Klicken Sie auf der Seite [Terminal-Lesegeräte](https://dashboard.stripe.com/terminal/readers) auf **Lesegerät registrieren**.
2. 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.
3. 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**.
4. 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).
5. 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.
6. 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.
var 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);
};
```