Fehlerbehebung

Schritt-fuer-Schritt-Checkliste fuer die haeufigsten Probleme. Top-down vorgehen - die meisten Probleme werden in den ersten drei Checks gefunden.

"Diese Buchungsseite ist nicht geoeffnet"

Widget deaktiviert. Dashboard > Bookings > Widgets > {Widget} > Aktiviert = ja.

"Keine Modelle verfuegbar"

Subaccount hat keine Modelle mit veroeffentlichter Preisstufe.

1. Dashboard > Fahrzeuge > Modelle - mindestens ein Modell muss existieren.
2. Dashboard > Preise - dieses Modell braucht veroeffentlichte Stufe.
3. Widget-Standard-Preisstufe zeigt auf echte Stufe.

Eingebettetes Widget erscheint nicht

Nach Wahrscheinlichkeit:

1. <script> Tag hat falsches data-slug oder Tippfehler. Seitenquelle pruefen.
2. data-target Element existiert nicht. Element muss im DOM sein, wenn Skript laeuft.
3. CSP blockiert iframe. Konsole pruefen. Strikte CSP braucht frame-src widget.levyelectric.com.
4. Skript in Textblock statt Codeblock. Squarespace/Wix strippen <script> aus Textbloecken.

CORS-Fehler bei Buchung

Bei "Origin not allowed" oder "Blocked by CORS policy" beim Pay-Klick:

1. Dashboard > Bookings > Widgets > {Widget} > Erlaubte Origins.
2. Exaktes Origin der hostenden Seite listen:
   • https://www.frankebikes.com matched NICHT https://frankebikes.com.
   • https://frankebikes.com matched NICHT http://frankebikes.com.
3. Beide https:// und https://www. listen, wenn Site weiterleitet.

GETs sind CORS-offen. Nur POSTs brauchen Allowlist.

Apple Pay Button erscheint nicht

Apple Pay nur wenn:

1. Kunde nutzt Safari mit eingerichteter Apple Pay.
2. Geraet hat Karte in Apple Wallet.
3. Widget Erlaubte Zahlungsmethoden > Apple Pay ist an.
4. Seite ueber HTTPS.

"Karte abgelehnt" bei Testkarte

Stripe-Testkarte 4242 4242 4242 4242 funktioniert nur mit Stripe-Test-Key. Ihr Widget nutzt Live-Key (richtig fuer Produktion). Zum Testen: echte Karte + sofort erstatten, oder Subaccount in Demo-Modus (Levy Admin schaltet um).

Vertrag speichert nicht / Signatur ist leer

Drei bekannte Ursachen:

1. Mit Maus auf Touchscreen gezeichnet. Finger oder Stift nutzen.
2. Aggressive Privacy-Einstellungen. Brave/Firefox-Resist-Fingerprinting kann Canvas brechen. Anderen Browser empfehlen.
3. Mitten im Zeichnen gecleared.

Bei nicht-speichern: Netzwerk-Tab pruefen auf 4xx bei /api/widget/{slug}/bookings/{id}/sign. Haeufige Ursache: Token in URL abgelaufen (24h). Kunde neu starten.

Stripe Terminal verbindet nicht

BBPOS WisePOS E:

1. Leser muss im gleichen WLAN wie iPad sein.
2. Leser power-cyclen (5 Sek gedrueckt halten).
3. POS Einstellungen > Kartenleser > Leser vergessen, neu entdecken.

Tap to Pay auf iPhone:

1. iOS 16.4+.
2. USA / GB / Kanada.
3. iCloud-Login.
4. Tap-to-Pay-AGB akzeptieren.

POS PIN abgelaufen

PINs sind 10 Min gueltig. Neue PIN in Dashboard > Bookings > POS generieren.

Bestaetigungs-E-Mail kam nicht an

1. Spam / Promotions Tab pruefen.
2. E-Mail-Eingabe pruefen.
3. Dashboard > Reservierungen > {Buchung} E-Mail-Log. "delivered" = erfolgreich gesendet, Mailserver filtert.
4. "bounced" = ungueltige Adresse.

Resend mit Bestaetigung erneut senden.

SMS-Bestaetigung kam nicht an

1. Nummer pruefen mit Laendercode.
2. Dashboard > Einstellungen > SMS - falls Twilio nicht konfiguriert, kein SMS (E-Mail laeuft trotzdem).
3. Manche Carrier (besonders Verizon) filtern - Whitelist-Tipp.

Aktionscode wird als ungueltig abgelehnt

Endpoint sagt "nicht gueltig" bei:

• Code existiert nicht.
• Code deaktiviert (Aktiv = nein).
• Code ausserhalb starts_at/ends_at.
• max_redemptions erreicht.
• applies_to deckt nicht den Warenkorb ab.
• Mindestmenge nicht erfuellt.

Code im Dashboard oeffnen, um echte Ursache zu sehen.

Inventory-Mismatch - "Ausverkauft" trotz Fahrzeugen

Engine respektiert model_inventory_caps fuer Widget-Abholort.

1. Dashboard > Car Sharing > Reservierungen > Inventory.
2. Cap fuer Modell + Ort + Fenster finden.
3. Cap erhoehen / entfernen.

Auch ueberlappende Reservierungen aus anderen Kanaelen pruefen.

Kunde sagt belastet aber keine Bestaetigung

Dashboard > Reservierungen nach E-Mail/Telefon suchen. Haeufig: Kunde hat Browser nach Zahlung geschlossen vor Confirmation-Render.

Buchung existiert, Karte belastet. Bestaetigung erneut senden.

Falls Buchung NICHT existiert aber Stripe zeigt Charge: Support-Ticket mit Charge-ID.

Webhook-Events feuern nicht

Levy Bookings feuert Webhooks bei booking.created, booking.confirmed, booking.cancelled, booking.refunded. Endpoint-URLs in Dashboard > Einstellungen > Webhooks.

1. Endpoint antwortet auf Test-Ping mit 2xx.
2. Webhook Log pruefen.
3. Bei 5xx: Retries mit Backoff bis 24h, dann Aufgabe.

Buchung sichtbar, IoT-Entriegelung fehlschlaegt

Kein Bookings-Problem - Buchung erfolgreich, aber IoT-Befehl fehlgeschlagen. Siehe IoT-Fehlerbehebung.

Haeufig: Fahrzeug-IoT offline. Dashboard > Fahrzeuge Status pruefen.

Verwandte Anleitungen

• Widget einbetten
• iPad POS einrichten
• FAQ