# Standorte verwalten Ihre Lesegeräte nach physischem Standort gruppieren und verwalten. Sie können die Verwaltung mehrerer Lesegeräte über verschiedene physische Standorte hinweg optimieren, indem Sie Standorte und Zonen verwenden. Standorte und Zonen sind hilfreich, indem sie jedes Lesegerät mit bestimmten Betriebsstandorten verknüpfen und garantieren, dass die richtigen regionalen Konfigurationen heruntergeladen werden. - **Standorte**: Ermöglicht es Ihnen, Lesegeräte zu gruppieren, ihren Verbindungsstatus zu überwachen und Ihre Einstellungen basierend auf dem physischen Standort zu ändern. Diese Funktionalität ist für Marktplätze mit mehreren verbundenen Konten von Vorteil. - **Zonen**: Bietet eine optionale Methode zur weiteren Kategorisierung von Standorten und Lesegeräten. Bei Verwendung von Zonen können Sie weitgefasstere Gruppen von Lesegeräten oder Standorten darstellen, wie größere geografische Regionen (zum Beispiel Länder) oder Untermarken für Organisationen. Mehrere Standorte können zu einer einzelnen Zone gehören, und Sie können eine hierarchische Struktur erstellen, indem Sie mehrere Zonen unter einer einzelnen Zone gruppieren. > Zonen bieten eine zusätzliche Möglichkeit, Standorte zu gruppieren. Sie müssen weiterhin Lesegeräte einem Standort zuweisen, und Sie können einen Standort nur einer Zone zuweisen. Beispiel für eine Organisationsstrategie (See full diagram at https://docs.stripe.com/terminal/fleet/locations-and-zones) ## Standorte Sie können einen Standort für jeden physischen Ort erstellen, an dem Ihre Lesegeräte eingesetzt werden. Sie können mehrere Lesegeräte für jeden Standort [registrieren](https://docs.stripe.com/terminal/fleet/register-readers.md) und diese Standorte innerhalb von Zonen verschachteln. Bevor Sie ein Lesegerät verwenden können, müssen Sie es bei einem Standort registrieren. Die erforderlichen [Adresseigenschaften](https://docs.stripe.com/api/terminal/locations/create.md#create_terminal_location-address) für einen Standort variieren je nach Land: ### Required Address Properties - Australia, Canada, Italy, Japan (Beta), Spain, United States: `line1`, `city`, `state`, `postal_code`, and `country` required - Austria, Belgium, Czech Republic, Denmark, Estonia (Beta), Finland, France, Germany, Hungary (Beta), Latvia (Beta), Liechtenstein (Beta), Lithuania (Beta), Luxembourg, Malaysia, Netherlands, New Zealand, Norway, Poland (Beta), Portugal, Romania (Beta), Slovakia (Beta), Sweden, Switzerland, United Kingdom: `line1`, `city`, `postal_code`, and `country` required - Bulgaria (Beta), Croatia (Beta), Cyprus (Beta), Ireland, Malta (Beta), Singapore, Slovenia (Beta): `line1`, `postal_code`, and `country` required - Gibraltar (Beta): `line1` and `country` required > Sie können das Dashboard oder die API verwenden, um ein `Location`-Objekt zu aktualisieren. Nachdem Sie einen Standort erstellt haben, können Sie das Land nicht mehr ändern. Erstellen Sie stattdessen einen neuen Standort in dem neuen Land und registrieren Sie dann alle mit dem alten Standort verbundenen Lesegeräte neu. ## Zonen Zonen sind die Gruppen der obersten Ebene, die entweder aus weitere Zonen oder aus Standorten bestehen können. Sie können weitere Zonen hinzufügen, die unter einer vorhandenen verschachtelt sind, wodurch zusätzliche Hierarchieebenen wie beispielsweise „Westküste“ erstellt werden. Die Unterteilung Ihrer Standorte in Zonen ist jedoch optional. ## Standorte und Zonen erstellen # API > Sie können keine Zonen mit der API erstellen oder ändern. Zunächst müssen Sie [Ihr Lesegerät bei einem Standort registrieren](https://docs.stripe.com/terminal/fleet/register-readers.md?dashboard-or-api=api), um Zahlungen annehmen zu können. Verwenden Sie zum Erstellen eines neuen Terminal-[Standort](https://docs.stripe.com/api/terminal/locations.md)-Objekts, das die API nutzt, die Anfrage zum [Erstellen des Standorts](https://docs.stripe.com/api/terminal/locations/create.md). ```curl curl https://api.stripe.com/v1/terminal/locations \ -u "<>:" \ -d display_name=HQ \ -d "address[line1]=1272 Valencia Street" \ -d "address[city]=San Francisco" \ -d "address[state]=CA" \ -d "address[country]=US" \ -d "address[postal_code]=94110" ``` ### Einen Standort für Konten mit Direct Charges erstellen Um einen Standort für ein Konto mit [Direct Charges](https://docs.stripe.com/connect/direct-charges.md) zu erstellen, verwenden Sie den Header `Stripe-Account` in Ihrer Anfrage. Nur das Connect-Konto, das Sie authentifizieren, kann auf diese Standorte zugreifen. Wenn das Unternehmen an mehreren physischen Standorten tätig ist, können Sie mehrere Standorte für einzelne Konten mit Direct Charges erstellen. ```curl curl https://api.stripe.com/v1/terminal/locations \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d display_name=HQ \ -d "address[line1]=1272 Valencia Street" \ -d "address[city]=San Francisco" \ -d "address[state]=CA" \ -d "address[country]=US" \ -d "address[postal_code]=94110" ``` ### Standort für Konten mit Destination Charges erstellen Bei Integrationen, die [Destination Charges](https://docs.stripe.com/connect/destination-charges.md) verwenden, gehören Standorte zum *Plattformkonto* und werden nicht streng verbundenen Konten zugeordnet. Wenn Ihre Plattform Konten mit Destination Charges mit Standorten verknüpfen muss, können Sie einen Verweis auf die relevanten Konten in der [Metadateneigenschaft](https://docs.stripe.com/api/terminal/locations/object.md#terminal_location_object-metadata) des Standorts speichern. #### curl ```bash curl https://api.stripe.com/v1/terminal/locations \ -u <>: \ -d "display_name"="HQ" \ -d "address[line1]"="1272 Valencia Street" \ -d "address[city]"="San Francisco" \ -d "address[state]"="CA" \ -d "address[country]"="US" \ -d "address[postal_code]"="94110" \-d "metadata[connected_account]"="{{CONNECTED_ACCOUNT_ID}}" ``` Wenn [Sie Ihr Lesegerät bei einem Standort registrieren](https://docs.stripe.com/terminal/fleet/register-readers.md), gruppiert der angegebene Standort das Lesegerät und legt dessen Ländereinstellungen fest. ## Verbindungs-Token beschränken (Serverseitig) (Smarte Lesegeräte) Bei der Erstellung eines [ConnectionToken](https://docs.stripe.com/api/terminal/connection_tokens.md) für das Terminal SDK können Sie einen `location`-Parameter angeben, um den Zugriff auf intelligente Lesegeräte einzuschränken. Wenn Sie einen Standort angeben, kann das ConnectionToken nur mit intelligenten Lesegeräten verwendet werden, die diesem Standort zugeordnet sind. Wenn Sie keinen Standort angeben, kann das ConnectionToken mit allen Lesegeräten verwendet werden. > Bei Bluetooth-Lesegeräten hat der `location` eines ConnectionToken keine Auswirkung. Dadurch wird sichergestellt, dass alle in der Nähe befindlichen Bluetooth-Lesegeräte auffindbar bleiben. ```curl curl https://api.stripe.com/v1/terminal/connection_tokens \ -u "<>:" \ -d "location={{TERMINALLOCATION_ID}}" ```