Marktplatz
Erweiterung v1.0.31

Card readers

Überblick

Verbindet mit Square. Die Kasse legt den Betrag auf ein Square Terminal an Ihrem Tresen. Die Kundschaft hält die Karte an das Gerät oder steckt sie hinein und kann ein Trinkgeld hinzufügen. Das Personal sieht, was eingezogen wurde, das Trinkgeld gesondert, dazu die Kartenmarke und die letzten vier Ziffern. Ein Bezahlvorgang endet als eingezogen oder als abgebrochen, mit dem Grund, den Square nennt. Ihr Betrieb ist der Verkäufer: Das Konto bei Square, das Zugriffstoken und das Geld gehören Ihnen, und Adminium ist an keiner Zahlung beteiligt. Die Karte liest das Terminal, sie geht an Square, und so erreicht keine Kartennummer Ihren Server. Eine Erstattung aus Adminium geht über Square zurück. Eine Interac-Zahlung (Kanada) wird nur am Terminal erstattet, deshalb lehnt Adminium sie ab. Erstattungen und Streitfälle, die im Square Dashboard gemacht werden, liest Adminium ebenfalls. Eingerichtet wird es in Studio → Zahlungen mit einem Zugriffstoken aus Ihrem eigenen Konto bei Square: dem Sandbox-Token für Testzahlungen, dem Produktions-Token für echte. Jedes Lesegerät koppeln Sie unter Zahlungen → Card readers mit einem Gerätecode, den Sie am Terminal eintippen. Adminium fragt die Lesegeräte vom Server aus ab, deshalb funktioniert ein Server ohne öffentliche Adresse. Square hält einen Terminal-Bezahlvorgang 30 Tage lang vor, und Adminium behält seine eigene Kopie dessen, was eingezogen wurde. In Deutschland wird Square nicht angeboten; nutzen Sie dort stattdessen über Card payments ein Stripe-Lesegerät. Es hat keine eigenen Bildschirme und keine eigenen Tabellen und arbeitet mit jeder App. Es braucht Adminium 0.3.60 oder neuer.

Woran sie sich anschließt

Diese hier ist an keine einzelne App gebunden. Sie arbeitet in Adminium selbst und in jeder App, die Erweiterungen aufnimmt.

Was die Verbindung ihr erlaubt

Es braucht ein Zugriffstoken aus Ihrem eigenen Konto bei Square: das Sandbox-Token für Testzahlungen und das Produktions-Token für echte. Beide werden verschlüsselt auf Ihrem Server gespeichert, und kein Teil der Erweiterung erreicht je einen Browser. Das Token öffnet das gesamte Konto bei Square, weil Square für eine eigene Anwendung kein engeres Token kennt; bewahren Sie es deshalb nur in Studio auf und erstellen Sie in der Square Developer Console ein neues, falls es je bekannt wird. Eigene Tabellen bringt es nicht mit. Seine Serverhälfte darf die zwei Adressen unten aufrufen, eine für den Test und eine für echte Zahlungen, und sonst nichts.

Adressen, die ihr Servercode erreichen darf

  • connect.squareupsandbox.com
  • connect.squareup.com

Diese Liste ist die ganze Liste: ein Aufruf an eine andere Adresse wird abgewiesen und protokolliert.

Was für die Verbindung nötig ist

Ein API-Schlüssel

Was sie hinzufügt

Wo sie auftaucht 4
  • In Adminium: seine Karte unter Studio → Zahlungen, auf der Sie das Zugriffstoken für die Sandbox oder für die Produktion einfügen, und „Prüfen“ sagt, zu wessen Konto bei Square es gehört
  • In Adminium: Zahlungen → Card readers, wo „Lesegerät koppeln“ dem Lesegerät einen Namen gibt und einen Gerätecode zeigt, den Sie am Square Terminal eintippen
  • An der Kasse: Der Betrag geht an das Square Terminal, die Kundschaft hält die Karte an oder steckt sie ein und kann ein Trinkgeld hinzufügen, und die Kasse zeigt, was eingezogen wurde, das Trinkgeld gesondert, mit Kartenmarke und letzten vier Ziffern; ein Bezahlvorgang endet als eingezogen oder als abgebrochen, mit dem Grund, den Square nennt
  • Erstattungen: Eine Erstattung aus Adminium geht über Square zurück, außer bei einer Interac-Zahlung (Kanada), die nur am Terminal erstattet wird; Erstattungen und Streitfälle aus dem Square Dashboard erscheinen unter Zahlungen → Aktivität
Tabellen, die sie mitbringt 0

Keine — sie bringt keine eigenen Tabellen mit.

Einstellungen, die Sie festlegen 1
  • Zugriffstoken

Wenn Sie sie ausschalten

Beim Trennen verschwinden die Oberflächen der Erweiterung. Die von ihr angelegten Tabellen werden nie verworfen, geschriebene Dateien nie gelöscht und hinzugefügte Zeilen nie entfernt — alles, was sie geschrieben hat, bleibt in Ihrer Datenbank. Die ihr anvertrauten Zugangsdaten werden dabei widerrufen und gelöscht.

Was bleibt

Jede bereits eingezogene Zahlung bleibt beim Datensatz erfasst, mit dem Trinkgeld gesondert sowie Kartenmarke und letzten vier Ziffern. Adminium hat eine eigene Kopie, deshalb ist eine Zahlung auch nach den 30 Tagen, die Square einen Terminal-Bezahlvorgang vorhält, noch vollständig lesbar. Eigene Tabellen hat es nicht mitgebracht. Ihr Konto bei Square und das Geld darauf bleiben unberührt.

Was verschwindet

Card readers verschwindet aus Studio → Zahlungen, und die Kasse kann keinen Betrag mehr auf ein Terminal legen. Erstattungen und Streitfälle aus dem Square Dashboard werden nicht mehr gelesen. Square kann ein Terminal nicht von außen entkoppeln; melden Sie deshalb jedes Terminal am Gerät selbst ab.

Zur Demo

Keine Demo auf dieser Seite ruft wirklich einen fremden Dienst auf. Jede Erweiterung bringt einen Ersatz-Transport mit, der aus eingebauten Daten antwortet, und der ist von Haus aus eingeschaltet. Echte Zugangsdaten gehören zum Selbsthosten und sind in der README der Erweiterung beschrieben.

So schalten Sie sie ein Keine der Demos auf dieser Website enthält es. Installieren Sie Card readers in Ihrem eigenen Adminium (0.3.60 oder neuer) unter Add-ons, öffnen Sie Studio → Zahlungen und verbinden Sie es mit dem Sandbox-Zugriffstoken aus Ihrem eigenen Konto bei Square, um Testzahlungen zu machen, bevor Sie das Produktions-Token nutzen. Lesegeräte koppeln Sie unter Zahlungen → Card readers.

Adminium ist mit diesem Unternehmen nicht verbunden.