Square einrichten
Nehmen Sie Kartenzahlungen über Square in Ihrem Buchungswidget und auf Ihrer Buchungsseite an. Kunden bezahlen mit Karte, und Apple Pay und Google Pay funktionieren, sobald Sie Ihre Website registrieren. Das Geld geht direkt auf Ihr eigenes Square-Konto. FullClass erhält oder verwahrt es nie.
Was Sie erhalten
- Einrichtung mit einem Klick, indem Sie sich bei Square anmelden. Sie müssen nichts kopieren oder einfügen, und FullClass erneuert die Verbindung für Sie.
- Ein Kartenformular in Ihrem Buchungswidget. Square stellt es bereit, daher gehen Kartennummern direkt an Square.
- Apple Pay und Google Pay auf den Websites, die Sie registrieren. Sie müssen keine Datei auf Ihrer Website hinzufügen.
- Rückerstattungen, die Sie auf der Seite der Buchung im Admin-Bereich auslösen können.
- Optionaler Abgleich von Rückerstattungen, die Sie in Square vornehmen, damit auch die Buchung in FullClass™ aktualisiert wird. Dafür braucht es einen Webhook (siehe unten).
Was Sie brauchen
- Ein Square-Konto.
- Die Inhaber-Anmeldung für FullClass. Nur der Inhaber kann die Zahlungseinstellungen öffnen.
- Etwa 15 Minuten für die Einrichtung eines Tests plus eine kurze Testbuchung.
Mit Square verbinden (der einfache Weg)
Mit Mit Square verbinden müssen Sie nichts kopieren. FullClass trägt Ihre Square-Daten für Sie ein und stellt Square als die Art ein, wie Kunden bezahlen.
- Melden Sie sich als Inhaber bei FullClass an und öffnen Sie Einstellungen → Zahlungen.
- Wählen Sie unter Wählen Sie, wie Kunden bezahlen die Option Square. Klicken Sie dann auf Mit Square verbinden.
- Melden Sie sich bei Square an und erlauben Sie den Zugriff. Sie kommen zurück auf die Seite Zahlungen, die Square erfolgreich verbunden. anzeigt.
- Das war's. Wenn Sie später keine Zahlungen über Square mehr annehmen möchten, klicken Sie auf derselben Seite auf Trennen.
Einrichtung in der Sandbox (zuerst empfohlen)
Die Sandbox ist der Testmodus von Square. Sie können mit Testkartennummern buchen und bezahlen, und es fließt kein echtes Geld. Testen Sie dort zuerst. Wenn alles passt, tauschen Sie Ihre Live-Daten ein. Square nennt sie „Production“.
Schritt 1. Ihre Square-Daten holen
- Melden Sie sich an bei developer.squareup.com. Das ist die Website von Square, um andere Apps wie FullClass zu verbinden.
- Öffnen Sie eine bestehende Anwendung oder erstellen Sie eine neue. Eine Anwendung ist hier einfach eine benannte Verbindung zu Ihrem Square-Konto.
-
Kopieren Sie unter Credentials die
Application ID (der Name der Verbindung) und das
Access token (das geheime Passwort dafür). Sandbox-IDs
beginnen mit
sandbox-. Production-IDs beginnen mitsq0idp-. - Öffnen Sie Locations in derselben Anwendung oder in Ihrem Square Dashboard. Kopieren Sie die Location ID des Standorts, der die Zahlungen erhalten soll.
Schritt 2. Die Daten in FullClass einfügen
- Melden Sie sich als Inhaber bei FullClass an.
- Öffnen Sie Einstellungen → Zahlungen.
- Wählen Sie unter Wählen Sie, wie Kunden bezahlen die Option Square. Sehen Sie Mit Square verbinden, öffnen Sie Zugangsdaten stattdessen manuell eingeben, um zu den Feldern zu gelangen.
- Fügen Sie Anwendungs-ID, Zugriffstoken und Standort-ID ein.
- Klicken Sie auf Änderungen speichern. (Den optionalen Webhook-Schlüssel können Sie später hinzufügen, siehe unten.)
Eine Buchung von Anfang bis Ende testen
- Öffnen Sie Ihre Buchungsseite so, wie ein Kunde es tun würde.
- Wählen Sie eine kostenpflichtige Veranstaltung und füllen Sie das Buchungsformular aus.
- Bezahlen Sie mit einer Testkarte für die Square-Sandbox. Square nennt sie auf seiner Seite Testkarten für die Square-Sandbox.
- Prüfen Sie, ob die Buchung im Admin-Bereich erscheint, über Square bezahlt, mit einer Square-Zahlungs-ID.
Apple Pay und Google Pay
Square prüft Ihre Website selbst. Sie müssen also keine Datei hinzufügen. Öffnen Sie Einstellungen → Zahlungen → Domains für Wallet-Zahlungen. Suchen Sie jede Website, auf der Ihr Widget erscheint, und klicken Sie auf Registrieren.
Die vollständige Anleitung und Lösungen finden Sie unter Apple Pay und Google Pay.
Live gehen
- Wechseln Sie auf developer.squareup.com zum Tab Production.
-
Kopieren Sie die Production-Application-ID (sie beginnt mit
sq0idp-), das Access token und die Location ID. - Fügen Sie sie in FullClass unter Einstellungen → Zahlungen ein und klicken Sie auf Änderungen speichern.
- Machen Sie eine kleine echte Buchung. Erstatten Sie sie dann auf der Seite der Buchung, um zu prüfen, ob Zahlungen und Rückerstattungen funktionieren.
Webhook-Signaturschlüssel (optional, empfohlen)
Ein Webhook ist eine Nachricht, die Square an FullClass sendet, wenn sich in Square etwas ändert. Ohne Webhook erscheint eine Rückerstattung, die Sie in Square vornehmen (nicht im Admin-Bereich von FullClass), nicht an der Buchung. Der Webhook-Signaturschlüssel ist ein Geheimnis, mit dem FullClass prüft, ob jede Nachricht wirklich von Square kommt.
- Öffnen Sie auf developer.squareup.com den Tab Webhooks Ihrer Anwendung.
-
Fügen Sie ein Webhook-Abonnement hinzu, das auf
https://your-fullclass-domain/webhooks/squarezeigt. - Abonnieren Sie die Rückerstattungsereignisse.
- Square erstellt einen Signaturschlüssel. Kopieren Sie ihn.
- Fügen Sie ihn in FullClass unter Einstellungen → Zahlungen in das Feld Webhook-Signaturschlüssel ein.
Rückerstattungen
- Erstatten Sie auf der Seite der Buchung im Admin-Bereich. Sie können den vollen Betrag oder einen Teil davon erstatten.
- Haben Sie auch den Webhook oben eingerichtet, aktualisieren Rückerstattungen, die Sie in Square vornehmen (zum Beispiel im Square Dashboard), die Buchung automatisch.
Eine Rückerstattung aus FullClass erreicht Square als Geldbetrag, nicht als Rückgabe der verkauften Artikel. Das liegt daran, dass Square anderen Apps nicht erlaubt, einzelne Artikel zurückzunehmen. Synchronisiert Square mit QuickBooks Online, wird die Rückerstattung ohne Steuer auf den Square sales item gebucht, egal wie der ursprüngliche Verkauf aussah. Bitten Sie Ihre Buchhaltung, diese Rückerstattungen so zu korrigieren.
- Rückerstattungen von Geschenkgutscheinen (ein Gutschein mit Geldguthaben): Buchen Sie den Betrag von den Umsatzerlösen auf Ihr Verbindlichkeitskonto für Geschenkgutscheine um, auf dem der Verkauf erfasst wurde.
- Andere Rückerstattungen (Buchungen, Kursguthaben, Privatveranstaltungen): Buchen Sie die in der Rückerstattung enthaltene Steuer von den Umsatzerlösen auf Ihr Konto für abzuführende Umsatzsteuer um.
Jede Rückerstattung in QuickBooks Online trägt die Beschreibung des ursprünglichen Verkaufs, etwa Gift card purchase oder die Buchungsnummer. Daran finden Sie sie.
Geschenkgutscheine in Ihrer Buchhaltung
Ein über Square verkaufter Geschenkgutschein erreicht Square als Verkauf mit einem Artikel. So kann Ihre Buchhaltung ihn von Kursumsätzen unterscheiden.
- Gift card: ein Gutschein mit Geldguthaben, ohne Steuer. Die Steuer wird später berechnet, wenn mit dem Gutschein ein Kurs bezahlt wird.
- Class pass: ein Guthaben für eine Anzahl von Kursen. Es trägt die Steuer, die Sie in Ihren Einstellungen für Geschenkgutscheine für Kursguthaben festgelegt haben.
Synchronisiert Square mit QuickBooks Online, ordnen Sie den Artikel Gift card Ihrem Verbindlichkeitskonto für Geschenkgutscheine zu, nicht den Umsatzerlösen. Dann zählen nicht eingelöste Gutscheine nicht als Umsatz.
Ein erstatteter Geschenkgutschein folgt dieser Zuordnung nicht. Die nötige Korrektur finden Sie unter Rückerstattungen.
Fehlerbehebung
- Das Kartenformular erscheint nicht
- Prüfen Sie, ob unter Wählen Sie, wie Kunden bezahlen Square gewählt ist und alle drei Angaben gespeichert sind. Die Application ID bestimmt Test oder Live. Ein Access token aus dem anderen Tab lässt die Kartenprüfung daher scheitern.
- Die Kartenprüfung schlägt fehl
- Application ID und Access token müssen aus demselben Tab in Square stammen (Sandbox oder Production). Sie können sie nicht mischen.
- Die Apple-Pay-Schaltfläche fehlt auf einer registrierten Website
- Prüfen Sie den Browser des Kunden. Apple Pay braucht Safari auf einem Mac, iPhone oder iPad. Google Pay braucht Chrome mit einer eingerichteten Zahlungskarte. Prüfen Sie auch, ob die Website unter Domains für Wallet-Zahlungen als Registriert angezeigt wird.
- Eine in Square vorgenommene Rückerstattung hat die Buchung nicht aktualisiert
- Sie brauchen ein Webhook-Abonnement in Square und einen gespeicherten Signaturschlüssel in FullClass. Siehe Webhook-Signaturschlüssel.
Siehe auch Fehlerbehebung → Zahlung schlägt fehl.