Problemlösung

Symptom: API-Anfragen geben den Fehler 401 Unauthorized zurück.

Lösung:

1. Überprüfen Sie, ob der API-Schlüssel korrekt ist und nicht abgelaufen ist
2. Stellen Sie sicher, dass Sie die richtige Umgebung verwenden (Test vs Live)
3. Prüfen Sie, ob der API-Schlüssel die erforderlichen Berechtigungen hat
4. Generieren Sie den API-Schlüssel neu, wenn das Problem weiterhin besteht

# API-Schlüssel-Format prüfen
sk_live_... # Live-Schlüssel
sk_test_... # Test-Schlüssel

Mehr erfahren in unseren Docs →

Symptom: Sie haben sich registriert, aber keine Bestätigungs-E-Mail erhalten.

Lösung:

1. Überprüfen Sie Ihren Spam- oder Junk-Ordner
2. Überprüfen Sie die eingegebene E-Mail-Adresse
3. Fügen Sie noreply@florentin.io zu Ihren Kontakten hinzu
4. Fordern Sie eine neue Bestätigungs-E-Mail auf der Anmeldeseite an
5. Kontaktieren Sie den Support, wenn Sie nach 15 Minuten keine E-Mail erhalten

Symptom: Ihr Webhook-Endpunkt empfängt keine Events.

Lösung:

1. Überprüfen Sie, ob Ihre Webhook-URL öffentlich erreichbar ist
2. Stellen Sie sicher, dass Ihr Endpunkt einen 2xx-Statuscode zurückgibt
3. Prüfen Sie, ob Ihr Server POST-Anfragen akzeptiert
4. Überprüfen Sie die Webhook-Logs in Ihrem Florentin-Dashboard
5. Stellen Sie sicher, dass die Webhook-Signaturvalidierung korrekt ist

# Webhook-Endpunkt testen
curl -X POST https://ihr-endpunkt.com/webhook \
  -H 'Content-Type: application/json' \
  -d '{"test": true}'

Mehr erfahren in unseren Docs →

Symptom: Rechnungen werden nicht erstellt oder zeigen falsche Beträge an.

Lösung:

1. Stellen Sie sicher, dass alle Nutzungsereignisse erfasst wurden
2. Prüfen Sie, ob der Abrechnungszeitraum abgeschlossen ist
3. Überprüfen Sie, ob der Kunde eine gültige Zahlungsmethode hat
4. Überprüfen Sie die Produktpreiskonfiguration
5. Kontaktieren Sie den Support, wenn Beträge falsch erscheinen

Symptom: API-Anfragen geben den Fehler 429 Too Many Requests zurück.

Lösung:

1. Überprüfen Sie Ihr aktuelles Rate-Limit in den Response-Headern
2. Implementieren Sie exponentielles Backoff für Wiederholungsversuche
3. Cachen Sie Antworten, wo möglich
4. Kontaktieren Sie den Support für eine Erhöhung des Rate-Limits

# Rate-Limit-Header
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1640000000