Zurück zur Anleitungs-Übersicht

Stripe Zahlungsintegration einrichten


1. Stripe Account erstellen

Falls Sie noch keinen Stripe Account haben, registrieren Sie sich unter dashboard.stripe.com/register.

Folgen Sie dem Registrierungsprozess und verifizieren Sie Ihr Unternehmen bzw. Ihren Verein.

2. Zahlungsmethoden aktivieren

Aktivieren Sie Ihre gewünschten Zahlungsmethoden in Ihrem Stripe Dashboard unter Einstellungen → Zahlungsmethoden

3. Eingeschränkten API-Schlüssel erstellen

Wir empfehlen die Verwendung eines eingeschränkten API-Schlüssels (Restricted Key) anstelle des Standard-Geheimschlüssels (sk_test_... und pk_test_... bzw. sk_live_... und pk_live_...). So erhält Rangetime nur die minimal notwendigen Berechtigungen.

  1. Öffnen Sie die API-Schlüssel Seite in Ihrem Stripe Dashboard
  2. Klicken Sie auf "Eingeschränkten Schlüssel erstellen" und wählen Sie dann "Bereitstellen dieses Schlüssels für eine Drittanbieteranwendung"
  3. Vergeben Sie einen Namen (z.B. "Rangetime") und Ihre bei der Bestellung gewünschte Rangetime URL (z.B. "https://mein-verein.rangetime.de") und setzen Sie den Haken bei "Berechtigungen für diesen Schlüssel anpassen"
  4. Für jede Berechtigung gibt es die Auswahl "Lesen", "Schreiben" und "Keine". Setzen Sie zuerst alle Berechtigungen auf "Keine" und setzen Sie dann explizit folgende Berechtigungen:
    Ressource Berechtigung
    Checkout SessionsSchreiben
    ProductsSchreiben
    PricesSchreiben
  5. Klicken Sie auf "Schlüssel erstellen"
  6. Kopieren Sie den generierten Schlüssel (beginnt mit rk_live_ oder rk_test_)

Den veröffentlichbaren Schlüssel (Publishable Key, beginnt mit pk_live_ oder pk_test_) finden Sie ebenfalls auf der API-Schlüssel Seite wenn Sie den Standard-Geheimschlüssel verwenden. Bei Verwendung des eingeschränkten API-Schlüssels ist der veröffentlichbare Schlüssel nicht relevant.

4. Schlüssel in Rangetime hinterlegen
  1. Gehen Sie in Rangetime zu Einstellungen → Bezahlungen
  2. Tragen Sie den Geheimschlüssel (Secret Key) ein. Verwenden Sie den eingeschränkten Schlüssel rk_live_ (im Testmodus rk_test_).
  3. Tragen Sie den veröffentlichbaren Schlüssel (Publishable Key) ein. Bei einem eingeschränkten Schlüssel (rk_live_ bzw. rk_test_) ist dieser Schlüssel nicht erforderlich.
  4. Klicken Sie auf "Speichern"
5. Testmodus vs. Live-Modus

Stripe bietet zwei Modi:

  • Testmodus — Verwenden Sie Test-Schlüssel (rk_test_, sk_test_ / pk_test_), um Zahlungen ohne echtes Geld zu testen. Stripe stellt dafür Testkartennummern bereit.
  • Live-Modus — Verwenden Sie Live-Schlüssel (rk_live_, sk_live_ / pk_live_) für echte Zahlungen im Produktivbetrieb.
Empfehlung: Testen Sie die Zahlungsintegration zuerst im Testmodus, bevor Sie auf Live-Schlüssel umstellen.
6. Optional: Zahlung vor Ort in Rangetime aktivieren

Unter Einstellungen → Bezahlung können Sie zusätzlich Zahlung vor Ort aktivieren. Beim Checkout erscheint dann eine Option, vor Ort zu bezahlen (z. B. bar) statt über Stripe. Diese Buchungen bleiben reserviert, bis ein Administrator sie unter bestätigt.

Stripe-Online-Zahlungen (Karte u. a.) werden weiterhin automatisch bestätigt — ohne manuelle Bestätigung.