quartiero · Anleitung

Kartenzahlung einrichten mit Stripe

Ihre Gäste zahlen per Kreditkarte, Apple Pay oder Google Pay direkt beim Buchen. Das Geld geht auf Ihr Konto, quartiero erfährt nur, dass bezahlt wurde.

Einmalige Einrichtung · etwa 30 Minuten

Bevor Sie anfangen

Was Stripe kostet. Es gibt keine Grundgebühr. Stripe behält je Zahlung einen Anteil ein — für europäische Karten derzeit rund 1,5 % plus 25 Cent, für Karten außerhalb Europas mehr. Die aktuellen Sätze stehen auf stripe.com/de/pricing. Bei einer Buchung über 600 € sind das etwa 9 €.
Zwei Modi, und das ist wichtig. Stripe hat einen Testmodus und einen Live-Modus. Im Testmodus fließt kein echtes Geld — dort richten wir alles ein und probieren es aus. Erst wenn eine Testzahlung sauber durchläuft, schalten Sie um. Oben rechts in Stripe steht, in welchem Modus Sie gerade sind.
1

Stripe-Konto anlegen

Falls Sie noch keins haben.

  1. dashboard.stripe.com/register aufrufen
  2. E-Mail-Adresse, Name und ein Passwort eingeben
  3. Als Land Deutschland wählen Das lässt sich später nicht mehr ändern.
  4. Die Bestätigungsmail von Stripe öffnen und den Link anklicken
Die Angaben zum Unternehmen — Bankverbindung, Steuernummer, Ausweis — können Sie zunächst überspringen. Für den Testmodus braucht Stripe sie nicht. Erst vor dem Umschalten auf echte Zahlungen müssen sie vollständig sein.
2

In den Testmodus wechseln

  1. Oben rechts im Stripe-Dashboard den Schalter Testmodus einschalten Die Oberfläche färbt sich orange — daran erkennen Sie den Testmodus jederzeit.
3

Die beiden Schlüssel holen

Stripe stellt zwei Schlüssel bereit. quartiero braucht beide.

  1. In Stripe auf Entwickler → API-Schlüssel
  2. Den Veröffentlichbaren Schlüssel kopieren Beginnt mit pk_test_
  3. In quartiero unter Einstellungen → Zahlungen → Stripe ins Feld Publishable Key einfügen
  4. Zurück in Stripe beim Geheimen Schlüssel auf Anzeigen klicken und kopieren Beginnt mit sk_test_
  5. Steht dort kein geheimer Schlüssel, oben rechts auf Geheimschlüssel erstellen klicken, die Karte Vollständiger Zugriff (außer sensible Vorgänge) wählen, einen Namen wie „quartiero" eingeben und erstellen. Bitte nicht „Vollzugriff" wählen. Dieser Schlüssel beginnt mit rk_test_ und kann keine Auszahlungen oder Überweisungen auslösen — quartiero braucht das auch nicht. Stripe zeigt ihn nur einmal an, also gleich kopieren.
  6. In quartiero ins Feld Secret Key einfügen
  7. Speichern
Den geheimen Schlüssel wie ein Passwort behandeln. Wer ihn hat, kann in Ihrem Namen Zahlungen auslösen und Geld erstatten. Nicht per Mail verschicken, keine Screenshots davon weitergeben. Falls er doch einmal in falsche Hände gerät: In Stripe unter „API-Schlüssel" neu erzeugen — der alte wird sofort ungültig.
4

Verbindung prüfen

  1. In quartiero auf Verbindung testen
  2. Es sollte eine Bestätigung erscheinen Kommt eine Fehlermeldung, stimmt meist der geheime Schlüssel nicht — siehe unten bei „Wenn etwas nicht klappt".
5

Die Rückmeldung einrichten

Damit quartiero erfährt, wann eine Zahlung eingegangen ist, meldet Stripe das aktiv zurück. Dafür braucht Stripe eine Adresse.

  1. In quartiero bei Webhook auf Kopieren Die Adresse ist für Ihr Konto persönlich und enthält Ihre Mandantenkennung.
  2. In Stripe auf Entwickler → Webhooks → Endpunkt hinzufügen
  3. Bei Endpunkt-URL die kopierte Adresse einfügen
  4. Bei den Ereignissen checkout.session.completed auswählen Nur dieses eine. Das Suchfeld hilft beim Finden.
  5. Auf Endpunkt hinzufügen
  6. Stripe zeigt jetzt ein Signing Secret — auf Anzeigen klicken und kopieren Beginnt mit whsec_
  7. In quartiero ins Feld Webhook Secret einfügen und Speichern
Warum dieser Schritt nötig ist. Ohne die Rückmeldung würde eine Buchung nach der Zahlung weiterhin als offen geführt. Sie müssten in Stripe nachsehen und in quartiero von Hand abhaken.
6

Eine Testzahlung durchführen

Jetzt einmal den ganzen Weg gehen, den auch Ihr Gast geht.

  1. In quartiero auf Test-Bezahlung Es öffnet sich eine echte Stripe-Bezahlseite über 1,00 €. Im Testmodus fließt kein Geld.
  2. Als Kartennummer 4242 4242 4242 4242 eingeben
  3. Als Datum ein beliebiges künftiges wählen, etwa 12/30
  4. Als Prüfziffer eine beliebige, etwa 123
  5. Auf Bezahlen
  6. Zurück in quartiero prüfen, ob die Zahlung angekommen ist
Kommt nichts an? Dann stimmt die Rückmeldung aus Schritt 5 nicht. In Stripe unter Entwickler → Webhooks auf Ihren Endpunkt klicken — dort steht bei jedem Versuch, ob er angekommen ist. Ein roter Eintrag nennt den Grund.
7

Auf echte Zahlungen umschalten

Erst wenn Schritt 6 sauber durchgelaufen ist.

  1. In Stripe die Angaben zum Unternehmen vervollständigen Bankverbindung, Steuernummer, Ausweis. Stripe führt Sie durch die Punkte. Die Prüfung dauert meist wenige Stunden, gelegentlich ein bis zwei Tage.
  2. Den Schalter Testmodus ausschalten
  3. Unter Entwickler → API-Schlüssel die beiden Live-Schlüssel holen Sie beginnen jetzt mit pk_live_ und sk_live_ bzw. rk_live_.
  4. In quartiero beide Felder überschreiben und speichern
  5. Den Webhook aus Schritt 5 im Live-Modus erneut anlegen Das ist der Punkt, den fast jeder übersieht: Webhooks gelten immer nur für einen Modus. Auch das Signing Secret ist ein anderes.
  6. Eine kleine echte Zahlung durchführen und wieder erstatten
Der häufigste Fehler beim Umschalten. Die Schlüssel werden getauscht, der Webhook aber nicht. Zahlungen laufen dann zwar durch, kommen in quartiero aber nie an — und die Buchung bleibt als unbezahlt stehen.

Wenn etwas nicht klappt

Die Meldung sagt meist genau, woran es liegt.

„Invalid API Key provided"

Der geheime Schlüssel passt nicht. Meist ist beim Markieren von Hand ein Zeichen verlorengegangen oder ein Leerzeichen mitgekommen.

Holen Sie ihn in Stripe über den Kopieren-Knopf neu, löschen Sie das Feld in quartiero vollständig und fügen Sie ihn neu ein.

„No such customer" oder „resource_missing"

Test- und Live-Schlüssel sind vermischt. Ein Schlüssel beginnt mit sk_test_ oder rk_test_, der andere mit sk_live_ oder rk_live_ — beide müssen zum selben Modus gehören, auch der veröffentlichbare.

Die Bezahlseite öffnet sich, aber quartiero merkt nichts

Das ist der Webhook aus Schritt 5.

Sehen Sie in Stripe unter Entwickler → Webhooks nach. Klicken Sie auf Ihren Endpunkt: Dort steht jeder Versuch mit Datum und Antwortcode. 200 heißt angekommen. Bei 400 stimmt meist das Signing Secret nicht, bei 404 die Adresse.

„Your account cannot currently make live charges"

Stripe hat die Prüfung Ihrer Unternehmensangaben noch nicht abgeschlossen.

Im Stripe-Dashboard steht oben, welche Angabe noch fehlt. Meist ist es das Ausweisdokument oder die Bankverbindung.

Die Testkarte wird abgelehnt

Prüfen Sie, ob Stripe im Testmodus ist — die Oberfläche wäre dann orange. Im Live-Modus funktioniert die Nummer 4242 4242 4242 4242 nicht.

Wann kommt das Geld auf meinem Konto an?

Stripe sammelt die Zahlungen und überweist sie gebündelt. Bei einem neuen Konto dauert die erste Auszahlung etwa sieben Tage, danach läuft es meist im Zwei-Tage-Rhythmus.

Den Rhythmus können Sie in Stripe unter Einstellungen → Auszahlungen ändern.

Muss ich die Stripe-Gebühr in der Buchhaltung erfassen?

Ja. Stripe zahlt Ihnen den Betrag abzüglich der Gebühr aus — für die Buchhaltung sind das zwei Vorgänge: der volle Erlös und die Gebühr als Aufwand.

Stripe stellt dafür monatlich eine Rechnung bereit, unter Einstellungen → Dokumente. Bitte klären Sie das mit Ihrem Steuerberater — diese Anleitung ist keine steuerliche Beratung.

Kurtaxe per Karte bezahlen lassen

Ist die Kartenzahlung (Stripe) eingerichtet, bekommt der Gast einen Bezahllink für die Kurtaxe: in der Mail „Gästekarte an den Gast weiterleiten“, sobald die Kurkarte ausgestellt ist, und in der Gästemappe unter der Gästekarte. Der Betrag ist der Kurtaxe-Satz der Unterkunft mal kurtaxpflichtige Personen mal Nächte, genau wie auf der Rechnung. In der Mailvorlage steht dafür der Platzhalter {{kurtaxeHinweis}}; fehlt er in einer selbst angepassten Vorlage, fügt quartiero den Hinweis vor der Signatur ein.

Letzter Zahltag ist der Tag vor der Abreise, per Karte oder bar bei Ihnen. Die Gästemappe nennt diese Frist unter dem Kurtaxe-Kasten und hebt sie am letzten Zahltag hervor. Ist die Kurkarte ausgestellt und die Kurtaxe an diesem Tag noch offen, schickt quartiero dem Gast einmal die Vorlage „Kurtaxe-Erinnerung (Tag vor der Abreise)“ mit Link und dem Hinweis auf die Barzahlung.

Zahlt der Gast per Karte, steht in der Buchung bei den Zahlungen „Kurtaxe per Karte bezahlt“ mit Datum; Anzahlung und Restbetrag bleiben unberührt, die Mappe zeigt „bezahlt“, und die Erinnerung entfällt. Barzahlungen werden in quartiero nicht gesondert verbucht, dafür gibt es bewusst keinen Knopf. Ohne Stripe lautet der Hinweis „in bar bei uns“, bei Buchungen „ohne Kurtaxe“ entfällt alles.

Nach der Kartenzahlung bekommt der Gast von Ihrem Postfach eine Quittung „Quittung Kurtaxe“ mit Belegnummer, Zahlungsdatum, Personen mal Nächte mal Satz, der Kinderregel und dem Hinweis, dass die Kurtaxe im Namen und für Rechnung der Gemeinde erhoben wird, ein durchlaufender Posten ist und keine Umsatzsteuer enthält. Den Wortlaut stimmen Sie am besten einmal mit Ihrem Steuerberater ab. Für die Kurtaxe bietet die Bezahlseite nur Karte an (auch Apple Pay und Google Pay), keine teureren Zahlarten.

Die Gebühr, die Stripe je Zahlung einbehält, holt quartiero kurz nach dem Zahlungseingang und danach stündlich nach. In der Belegungsübersicht für den Steuerberater steht unten die Tabelle „Kartenzahlungen (Stripe) mit Gebühren“: Datum, Gast, Unterkunft, Art, Betrag, Gebühr und Auszahlung, mit Summe; in der Kurtaxe-Übersicht nur die Kurtaxe-Zahlungen.