Standorte verwalten
Wenn Ihr Terminal-Deployment zahlreiche Lesegeräte an mehreren Standorten umfasst, kann die Nachverfolgung der Geräte schnell kompliziert werden. Mit Standorten können Sie Lesegeräte und Aktivitäten verwalten, indem Sie diese einem physischen Geschäftsstandort zuordnen. Die Standorte sorgen auch dafür, dass die Lesegeräte die korrekten regionalen Konfigurationen herunterladen.
Verwenden Sie das Objekt Terminal-Standorte, um Lesegeräte zu gruppieren, deren Verbindungsstatus zu prüfen, und ihre Einstellungen abhängig vom physischen Standort anzupassen. Dies kann besonders für Marktplätze mit vielen verbundenen Konten hilfreich sein.
Nach dem Erstellen von Standorten können Sie diese verwenden, um Lesegeräte zu gruppieren, die Lesegeräterkennung zu verbessern, ihre Einstellungen abhängig vom physischen Standort anzupassen und vieles mehr.
Erstellen Sie einen Standort Serverseitig Dashboard
Erstellen Sie für jeden physischen Standort ein Objekt Standort, an dem Ihre Lesegeräte betrieben werden. Wenn Sie für Ihre Geschäftstätigkeit die Lesegeräte häufig neu platzieren müssen, können Ihre Standorte auch Adressen verwenden, die den Hauptgeschäftssitz repräsentieren.
Um mit der API einen neuen Standort zu erstellen, verwenden Sie die Anfrage Standort erstellen.
Die erforderlichen Adresseigenschaften eines Standorts unterscheiden sich je nach Land:
Länder | Erforderliche Adresseigenschaften |
---|---|
Australien Kanada Italien Spanien USA | line1 , city , state , postal_code , and country |
Österreich+ Belgien Tschechische Republik+ Dänemark Finnland+ Frankreich Deutschland Luxemburg+ Malaysia+ Niederlande Neuseeland+ Norwegen+ Portugal+ Schweden Schweiz+ Vereinigtes Königreich | line1 , city , postal_code , and country |
Irland Singapur | line1 , postal_code , and country |
Einen Standort für Konten mit Direct Charges erstellen
Um einen Standort für ein Konto mit Direct Charges 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.
Standort für Konten mit Destination Charges erstellen
Für Integrationen, die Destination Charges verwenden, gehören Standorte zum platform-Konto und werden nicht streng verbundenen Konten zugeordnet. Wenn Ihre Plattform Konten, die Destination Charges verwenden, Standorten zuordnen müssen, können Sie einen Verweis auf das entsprechende Konto/die entsprechenden Konten in der Eigenschaft Metadaten des Standorts speichern.
Sie können Standorte auch über das Stripe Dashboard erstellen, auf der Seite Standorte verwalten.
Wenn Sie Ihr Lesegerät einem Standort zuweisen, 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 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.
Notiz
Auf Bluetooth-Lesegeräte hat die location
eines ConnectionToken keine Auswirkungen. Dadurch wird sichergestellt, dass Bluetooth-Lesegeräte in Ihrer Nähe immer erkannt werden.
Ein Lesegerät an einem Standort registrieren
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 oder um ein Bluetooth-Lesegerät handelt.
Intelligente Lesegeräte Serverseitig
Registrieren Sie die intelligenten Lesegeräte (Verifone P400, BBPOS WisePOS E und Stripe Reader S700) während der Registrierung mit einem bestimmten Standort.
Sie können Lesegeräte auch im Dashboard registrieren, entweder auf der Seite Lesegeräte oder auf der Seite Standorte verwalten.
Bluetooth-Lesegeräte Clientseitig
Registrieren Sie Bluetooth-Lesegeräte (Stripe Reader M2, BBPOS Chipper 2X BT und BBPOS WisePad 3) während der Verbindungsherstellung bei einem Standort, indem Sie die locationId
in Ihrer BluetoothConnectionConfiguration
angeben. Bei Bedarf können Sie erkannte Lesegeräte bei dem zuletzt verwendeten Standort registrieren, indem Sie die reader.locationId
übergeben.
Notiz
Versionen des Terminal SDK vor v2.0.0 unterstützen keine Registrierung von BBPOS Chipper 2X BT- oder WisePad 3-Lesegeräten bei Standorten.
Erkannte Lesegeräte filtern
Intelligente Lesegeräte Clientseitig
Ihre Anwendung verwendet die SDK-Methode discoverReaders
, um nach Lesegeräten zu suchen, mit denen sie sich verbinden kann. Intelligente Lesegeräte wie das Verifone P400 oder das BBPOS WisePOS E lassen sich leichter finden, wenn Sie die Ergebnisse nach Standort filtern.
Mit dem folgenden Code gibt der Rückruf Ihrer App nur Lesegeräte an einem bestimmten Standort zurück. Sie finden die ID des Standorts im Dashboard auf der Seite Standorte verwalten.
Bluetooth-Lesegeräte Client side
Da mobile Lesegeräte eine Verbindung über Bluetooth herstellen, werden mit discoverReaders
alle Lesegeräte in der Nähe zurückgegeben. Standardmäßig wird keine zusätzliche Filterung vorgenommen. Sie können jedoch den zurückgegebenen Parameter registeredLocation
für das Reader-Objekt verwenden, um in Ihrer Anwendung optional eine zusätzliche Filterung anzuwenden.