Standorte 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.

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 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 für einen Standort variieren je nach Land:

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

curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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

curl https://api.stripe.com/v1/terminal/locations \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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}}

curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d location=
{{LOCATION_ID}}