Häufige Probleme und Fehlerbehebung

Falls Ihr Problem nicht hier aufgeführt ist, senden Sie eine E-Mail an support@rowie.io mit Screenshots und der Transaktions-ID (oder Session-ID oder Rechnungsnummer), wenn möglich.

„Setup required" bei Banking oder Tap to Pay

Der Account-Bildschirm des mobilen POS zeigt ein Setup required-Badge in der Banking-Zeile, und Tap to Pay / Terminal Readers sind deaktiviert, bis das Stripe Connect-Onboarding abgeschlossen ist und Charges aktiviert sind.

• Vendor-Portal → Banking (Seitenleiste → Gruppe FINANCE) → Status prüfen.
• Falls das Onboarding nicht abgeschlossen ist, durchlaufen Sie das gehostete Formular von Stripe – es zeigt Ihnen genau an, was fehlt (Ausweis, Bankdaten, Geschäftsangaben).
• Erstmalige Einrichtungen können 1–2 Tage benötigen, bis Stripe alles verifiziert hat.

Die Prüfung „bereit für Charges" im App-Code lautet connectStatus.hasConnectedAccount && connectStatus.chargesEnabled – beide müssen true sein.

„Cannot delete location — it still has …"

Das Portal blockiert die Deaktivierung eines Standorts, wenn abhängige Datensätze existieren. Die genaue Meldung listet auf, was blockiert. Die Prüfungen (rowie-api/src/routes/locations.ts):

• Offene oder in Bearbeitung befindliche table sessions – diese zuerst begleichen oder stornieren.
• Menus, floor plans, aktive bookings, booking pages – einem anderen Standort zuweisen oder zuvor löschen.
• Einziger Standort in der Organisation – Sie können Ihren letzten nicht löschen.

Abhängigkeiten verschieben, dann erneut versuchen.

„Cannot delete menu with open sessions or tabs"

Ein Menü (Catalog) lässt sich nicht löschen, solange noch offene Sessions oder Tabs darauf laufen. Begleichen oder stornieren Sie diese auf der Tables-Seite und versuchen Sie das Löschen erneut. Das gleiche Muster gilt für:

• Floor plans / Tables mit aktiven Sessions.
• Events / Ticket Tiers mit verkauften Tickets.
• Vendor Subscription Plans mit aktiven Abonnenten (diese zuerst kündigen oder migrieren).
• Tip Pools, die sich nicht im Entwurfsstatus befinden (Sie können Pools nur löschen, solange sie sich noch im Entwurf befinden).

„Authentication failed" oder Hängenbleiben nach langer Untätigkeit

Auth-Tokens laufen nach 15 Minuten ab; die mobile App und das Vendor-Portal aktualisieren bei einem 401 automatisch. Falls die Aktualisierung fehlschlägt (z. B. weil das Refresh-Token nach 7 Tagen ebenfalls abgelaufen ist oder Sie sich auf einem anderen Gerät angemeldet wurden und herausgekickt wurden), sehen Sie einen „Authentication failed"-Toast und werden zur Anmeldung zurückgeschickt.

• Nur mobil: Wenn Sie sich auf einem zweiten Gerät anmelden, erhält das erste Gerät SESSION_KICKED und wird zwangsabgemeldet – das ist beabsichtigt (Schutz vor gestohlenen Telefonen).
• Das Vendor-Portal erzwingt keine Single-Session – Sie können mehrere Tabs offen halten.

Falls Sie mitten in einem Bildschirm hängen: ab- und wieder anmelden.

Tab-Schließung fehlgeschlagen / „Payment failed"

Wenn eine gespeicherte Karte off-session belastet wird, um einen Tab zu schließen, und Stripe sie ablehnt, wird die Session auf open zurückgesetzt, sodass Sie es erneut versuchen können. Häufige Ursachen:

• Karte erfordert für jede Belastung eine erneute Authentifizierung / 3DS.
• Betrugsregel des Issuers bei Off-Session-Belastungen.
• Unzureichende Deckung.

Bekannte Einschränkung: Stripe-Idempotenzschlüssel für close-tab sind 24 Stunden lang stabil. Falls der erste close-tab-Versuch abgelehnt wurde, gibt ein sofortiger erneuter Versuch mit derselben Karte denselben abgelehnten Intent zurück. Workaround: Nehmen Sie stattdessen eine frische Tap-to-Pay-Zahlung an, anstatt über die gespeicherte Karte zu schließen, oder lassen Sie den Kunden eine neue Karte hinterlegen.

„Payment setup required" im Checkout

Der mobile POS zeigt dies an, wenn Sie eine Belastung auslösen wollen, aber Stripe Connect noch nicht vollständig eingerichtet ist. Gleiche Lösung wie beim „Setup required"-Badge oben – schließen Sie das Banking-Onboarding ab.

Belege: Senden und erneutes Senden

Tap-to-Pay-Belege müssen explizit gesendet werden – Stripe liefert sie für card_present-Transaktionen nicht automatisch aus.

• Geben Sie auf dem Payment-Result-Bildschirm direkt nach einer Belastung die E-Mail-Adresse des Kunden ein und tippen Sie auf Send receipt.
• Später öffnen Sie eine beliebige Transaktion in History → Send receipt.

Falls Belege nicht ankommen, prüfen Sie zuerst den Spam-Ordner und dann, ob die E-Mail-Adresse auf der Transaktion korrekt ist.

Echtzeitdaten wirken veraltet

Die App nutzt Socket.IO, um Updates zu pushen (Orders, Sessions, Tabs, Menüs, Bookings, Invoices, Pay Runs). TanStack Query ist mit unendlicher Stale Time und ohne Polling konfiguriert – Invalidierungen kommen über Socket-Events.

Falls etwas veraltet aussieht:

1. Auf dem Bildschirm zum Aktualisieren ziehen (mobil) oder die Seite neu laden (Vendor-Portal).
2. Ab- und wieder anmelden, um eine neue Socket-Verbindung zu erzwingen.
3. Prüfen, ob die API-URL von Ihrem Gerät aus erreichbar ist.

Der Vendor-Socket verbindet sich automatisch mit frischen Tokens neu (dynamischer Auth-Callback). Der mobile Client versucht bis zu 10 Reconnects mit einem Backoff zwischen 1 und 5 s.

Rate-Limit erreicht (HTTP 429) auf öffentlichen Menü-, Table- oder Booking-Seiten

Die API begrenzt das Anlegen von öffentlichen Preorders, Sessions und Bookings pro IP + Session-ID, um Betrug einzudämmen (eingeführt nach dem Vorfall im April 2026). Normaler Kundentraffic wird dies nicht auslösen. Falls ein Lasttest oder eine versehentliche Retry-Schleife dies auslöst, warten Sie, bis das Zeitfenster abläuft (eine Minute), und versuchen Sie es erneut.

Tap-to-Pay-Schaltfläche ist ausgegraut

• Apple Tap to Pay Entitlement: Beim ersten Mal auf einem neuen Stripe-Connect-Konto benötigt Apple 1–2 Tage, um das Gerät zu aktivieren.
• Banking nicht aktiv: siehe „Setup required" oben.
• Falsches Gerät: Tap to Pay benötigt iPhone XS oder neuer mit iOS 16.4+ und Code-Sperre oder ein NFC-fähiges Android-Gerät (SDK 26+).

Konto zur Überprüfung markiert

Wenn die Betrugsheuristik anschlägt (Anteil blockierter oder fehlgeschlagener Charges über den Schwellwerten), wird review_status des Kontos auf needs_review umgeschaltet und automatische Auszahlungen pausieren. Wenden Sie sich an den Support – sobald Rowie-Mitarbeitende das Konto aus der Admin-Queue freigegeben haben, werden Auszahlungen fortgesetzt. Die Nur-Lese-Nutzung des Produkts bleibt funktionsfähig.