Stripe mit GleiNei verbinden

Step 0 · Voraussetzungen

• Aktives Stripe-Konto (inkl. verifizierter Firma/Organisation).
• Zugang zu deinem GleiNei-Admin (z. B. https://deinname.gleinei.com/app/).
• Deine GleiNei-Instanz ist installiert und erreichbar.

Step 1 · Stripe-Account vorbereiten

1. Melde dich in Stripe an (Stripe-Dashboard).
2. Stelle sicher, dass dein Konto vollständig eingerichtet ist (Firmendaten, Bankkonto, Auszahlungen).
3. Wechsle in den gewünschten Modus:
   • Testmodus zum Ausprobieren (Schalter „Testdaten anzeigen“ im Stripe-Dashboard).
   • Live, sobald du mit echten Kunden starten möchtest.

Step 2 · API-Schlüssel & Webhook-Secret vorbereiten

2.1 · Secret Key & Publishable Key

1. Stripe-Dashboard → Entwickler → API-Schlüssel.
2. Notiere dir:
   • Publishable key (beginnt mit pk_test_… oder pk_live_…)
   • Secret key (beginnt mit sk_test_… oder sk_live_…)

2.2 · Webhook-Endpoint & Webhook-Secret

GleiNei benötigt Stripe-Webhooks, damit nach einer erfolgreichen Zahlung automatisch: Ticket/Abo/10er-Karte/Social Ticket erzeugt wird und die Bestätigungs-E-Mail an den Gast versendet wird.

1. Stripe-Dashboard → Entwickler → Webhooks.
2. Klicke auf „+ Endpoint hinzufügen“.
3. Trage als URL deinen GleiNei-Webhook ein, z. B.:

https://deinname.gleinei.com/app/webhook_stripe.php

4. Wähle als Ereignisse mindestens:
   • checkout.session.completed
   • payment_intent.succeeded
5. Speichere den Endpoint.
6. Öffne den Endpoint in der Webhook-Liste und notiere das Signing secret (Webhook-Secret, beginnt mit whsec_…).

Step 3 · Stripe-Daten in GleiNei hinterlegen

1. Melde dich im GleiNei-Admin an.
2. Gehe in Einstellungen (je nach Version z. B. „System-Check & Stripe“).
3. Trage ein:
   • Modus: Test oder Live (muss zum Stripe-Modus passen)
   • Stripe Secret Key: sk_test_… oder sk_live_…
   • Stripe Publishable Key (optional, z. B. für Checkout-Buttons im Frontend)
   • Stripe Webhook Secret: whsec_…
4. Speichern und im Menü System-Check prüfen, ob Stripe korrekt konfiguriert ist.

Step 4 · Produkte in Stripe anlegen (inkl. Metadaten)

Deine Online-Tickets werden in Stripe als Produkte und Preise angelegt. GleiNei erkennt anhand von Metadaten, um welche Ticketart es sich handelt.

4.1 · Ticketarten, die GleiNei unterstützt

4.2 · Produkt anlegen

1. Stripe-Dashboard → Produkte → + Produkt hinzufügen.
2. Trage ein:
   • Produktname (z. B. „Eintritt Kind (Tagesticket)“)
   • Optional Beschreibung
   • Preis anlegen (einmalig oder wiederkehrend – je nach Ticketart)
3. Produkt speichern.

4.3 · Wichtige Metadaten setzen

Damit GleiNei weiß, wie das Ticket behandelt werden soll, musst du Metadaten am Produkt oder am Preis hinterlegen.

* Empfehlung: Für Social Tickets fund_id setzen, damit die Zuordnung eindeutig ist.

4.4 · Beispiel-Metadaten

Einzelticket (Tagesticket)

pass_type = single

10er-Karte

pass_type = ten_card
max_uses  = 10

Monats-Abo

pass_type = subscription

Social Ticket (über Sozialtopf #1)

pass_type = social
fund_id   = 1

Wo eintragen? Stripe Produkt oder Preis → Bereich Metadaten → Schlüssel/Wert-Paare ergänzen.

Step 5 · Zahlungslinks in Stripe erstellen

Zahlungslinks sind die einfachste Möglichkeit, Tickets zu verkaufen. Der Link führt auf eine Stripe-Checkout-Seite. Nach erfolgreicher Zahlung erzeugt GleiNei automatisch den passenden Pass und die E-Mail.

5.1 · Payment Link anlegen

1. Stripe-Dashboard → Produkte → Produkt wählen (oder Menü „Zahlungslinks“).
2. „Zahlungslink erstellen“ / „+ Neuer Zahlungslink“.
3. Preis auswählen (Einmalzahlung oder Abo).
4. Optional konfigurieren:
   • Menge (fix oder vom Kunden wählbar)
   • Branding, Bestellbestätigung etc. in Stripe
5. Link erstellen und kopieren (z. B. https://buy.stripe.com/…).

5.2 · Zahlungslinks verwenden

• Auf deiner Website („Jetzt Ticket kaufen“ Button)
• Google Business Eintrag
• E-Mails, Social Posts, QR-Codes
• In deiner GleiNei-Instanz als Preis-/Direkt-Link (je nach Setup)

Step 6 · Testen, bevor du live gehst

1. Stripe in den Testmodus schalten.
2. Testprodukte mit Metadaten anlegen (wie oben).
3. Test-Zahlungslinks erstellen.
4. Testzahlungen mit Stripe-Testkarten durchführen (z. B. 4242 4242 4242 4242).
5. Im GleiNei-Admin prüfen:
   • Werden Pässe/Tickets korrekt angelegt?
   • Werden Check-ins sauber erfasst?
   • Kommen Bestätigungs-E-Mails an?
6. Erst wenn im Test alles sauber läuft: auf Live umschalten.

Step 7 · Häufige Fehler & Tipps

7.1 · Tickets/Pässe werden nicht angelegt

• Webhook-URL korrekt? (/app/webhook_stripe.php)
• Webhook-Secret (whsec_…) in GleiNei eingetragen?
• Ereignisse checkout.session.completed und payment_intent.succeeded aktiviert?
• Metadaten pass_type am Produkt oder Preis gesetzt?

7.2 · Falsche Ticketart

• Wert von pass_type exakt? (z. B. ten_card, nicht tencard)
• Bei Mehrfachkarten: max_uses korrekt?

7.3 · Social Tickets falscher Topf

• pass_type = social gesetzt?
• fund_id entspricht einer existierenden Sozialtopf-ID in GleiNei?

Support

Wenn du trotz dieser Schritte nicht weiterkommst, sende bitte eine kurze Nachricht mit Beispiel-Zahlung (Datum/Uhrzeit) und einer Stripe-Referenz (Payment Intent ID oder Checkout Session ID).

Platzhalter in dieser Doku: Ersetze deinname.gleinei.com durch deine tatsächliche Subdomain/Domain.