Stripe verbinden
Online-Zahlungen über Stripe akzeptieren: Karten, Apple Pay, Google Pay.
1. Überblick#
Stripe ist eine globale Zahlungsplattform. Im Meni-Verzeichnis kann Stripe in 46 Ländern verbunden werden. Die Integration Cenaly + Stripe ermöglicht:
- 💳 Zahlungen akzeptieren mit Karten (Visa, Mastercard, AmEx)
- 📱 Apple Pay / Google Pay — Zahlung mit einem Tippen
- 💰 Auszahlungen erhalten auf Ihr Bankkonto
- 🔄 Rückerstattungen bearbeiten aus dem Admin-Panel
- 💵 Trinkgelder — der Gast fügt beim Bezahlen ein Trinkgeld hinzu
- 📊 Berichte — vollständige Finanzanalyse
2. Voraussetzungen#
- ✅ Meni-Konto (Online-Zahlung ist in jedem Plan verfügbar, auch im kostenlosen)
- ✅ Stripe-Konto (kostenlose Registrierung auf stripe.com)
- ✅ Bankkonto für Auszahlungen (in der Währung Ihres Landes)
- ✅ Dokumente zur Verifizierung (Pass / ID, Firmendokumente)
Unterstützte Länder#
Stripe kann in 46 Ländern verbunden werden:
| Region | Länder |
|---|---|
| Europa (EWR) | Österreich, Belgien, Bulgarien, Kroatien, Zypern, Tschechien, Dänemark, Estland, Finnland, Frankreich, Deutschland, Griechenland, Ungarn, Irland, Italien, Lettland, Liechtenstein, Litauen, Luxemburg, Malta, Niederlande, Norwegen, Polen, Portugal, Rumänien, Slowakei, Slowenien, Spanien, Schweden |
| Europa (außerhalb des EWR) | Vereinigtes Königreich, Schweiz, Gibraltar |
| Amerika | USA, Kanada, Mexiko, Brasilien |
| Asien | Japan, Singapur, Hongkong, Malaysia, Thailand, Indien, Indonesien |
| Naher Osten | VAE |
| Ozeanien | Australien, Neuseeland |
3. Stripe-Konto erstellen#
Schritt 1. Registrierung#
- Gehen Sie zu stripe.com → Start now
- Geben Sie die E-Mail an und erstellen Sie ein Passwort
- Bestätigen Sie die E-Mail
Schritt 2. Verifizierung des Unternehmens#
Stripe fragt ab:
| Dokument | Beschreibung |
|---|---|
| Unternehmenstyp | Einzelunternehmer, GmbH, natürliche Person |
| Name | Juristischer und Handelsname |
| Adresse | Juristische Adresse des Unternehmens |
| ИНН / Tax ID | Steueridentifikationsnummer |
| Dokument der Geschäftsführung | Pass oder ID-Karte |
| Bankverbindung | IBAN oder Kontonummer |
| Beschreibung der Tätigkeit | „Restaurant / Café / Essenslieferung“ |
Die Verifizierung dauert in der Regel 1–3 Werktage.
Schritt 3. API-Schlüssel erhalten#
- Im Stripe-Dashboard: Developers → API keys
- Kopieren Sie:
- Publishable key (pk_live_...)
- Secret key (sk_live_...)
4. Mit Cenaly verbinden#
Verbunden wird Ihr eigenes Stripe-Konto: Das Geld des Gastes geht direkt auf Ihr Stripe-Guthaben, Cenaly hält es nicht.
Öffnen Sie App-Shop → Kategorie „Finanzen“ → Stripe-Karte → „Einrichten“ — der Verbindungsblock öffnet sich als Modal direkt im Shop. Der gewohnte Weg funktioniert ebenfalls: Standorte → Standort-Karte → Tab „Zahlungen“ (Sektion „Zahlung durch Gast“), Schaltfläche „Verbinden“ bei der Stripe-Karte.
Verbindungsassistent (empfohlen)#
Der schrittweise Assistent (≈10 Minuten) führt durch den gesamten Prozess und zeigt, wo im Stripe-Dashboard geklickt werden muss:
- Modus wählen — Test oder Live. Der Modus in Stripe und der Umschalter „Test / Live“ in Cenaly müssen übereinstimmen.
- Schlüssel kopieren — Developers → API keys: Secret key (
sk_test_…/sk_live_…) ist erforderlich, Publishable key (pk_…) — optional. - Webhook hinzufügen — Developers → Webhooks → Add endpoint, und in das Feld Endpoint URL fügen Sie die Meni-Webhook-Adresse ein, die der Assistent über die Schaltfläche „Kopieren“ bereitstellt. Ohne Webhook meldet Stripe nicht, dass die Bestellung bezahlt ist, und die Bestellung kann im Status „wartet“ bleiben.
- Ereignisse wählen — im Block „Select events“ fügen Sie unbedingt
checkout.session.completedhinzu (genau dieses bestätigt die Bezahlung der Bestellung), und für verzögerte Zahlungsmethoden — zusätzlichcheckout.session.async_payment_succeededundcheckout.session.async_payment_failed. Drücken Sie dann „Add endpoint“. Ohne diese Ereignisse ist der Webhook erstellt, meldet aber nichts über die Bezahlung. - Webhook signing secret kopieren (
whsec_…) — ein optionales Feld, aber damit wird die Signaturprüfung der Benachrichtigungen aktiviert. - Verbinden — die eingegebenen Werte gehen an ein geschütztes Backend.
Kurzformular#
Wenn Sie bereits wissen, wo in Stripe was liegt, öffnen Sie das Inline-Verbindungsformular und füllen Sie dieselben Felder aus: Secret key, Webhook signing secret (opt.), Publishable key (opt.) plus den Modus-Umschalter.
5. Einrichten der Zahlungsmethoden#
Bankkarten#
Bei der Verbindung mit Stripe automatisch aktiviert:
- Visa / Mastercard — alle Länder
- American Express — die meisten Länder
- Diners Club / Discover — ausgewählt
Apple Pay und Google Pay#
Separate Schalter gibt es in Cenaly dafür nicht: Die Zahlung läuft auf der hosted-Seite Stripe Checkout, daher werden die Wallets auf der Seite von Stripe aktiviert.
- Google Pay — funktioniert sofort nach der Verbindung mit Stripe (Android, Chrome).
- Apple Pay — Stripe verlangt die Bestätigung der Domain: Settings → Payment methods → Apple Pay → Add new domain. Nach der Verifizierung erscheint die Schaltfläche auf iOS/Safari.
Andere Methoden#
Über das Stripe Dashboard können Sie aktivieren:
| Methode | Länder | Beschreibung |
|---|---|---|
| iDEAL | Niederlande | Banküberweisung |
| Bancontact | Belgien | Banküberweisung |
| SEPA Direct Debit | EU | Abbuchung vom Bankkonto |
| Przelewy24 | Polen | Online-Zahlungen |
| giropay | Deutschland | Banküberweisung |
| EPS | Österreich | Banküberweisung |
| Boleto | Brasilien | Zahlungsbeleg |
Aktivieren Sie die gewünschten Methoden im Stripe Dashboard → Settings → Payment methods.
6. Trinkgelder#
Einrichtung#
- Standorte → Karte des Standorts → Tab „Allgemein“ → Schalter „Trinkgeld“.
- So funktioniert es:
| Parameter | Beschreibung |
|---|---|
| Vorgeschlagene Beträge | Die Voreinstellungen werden nach dem Land des Betriebs eingefügt: 18/20/25 % für die USA, 15/18/20 % für Kanada, 10/15/20 % für Georgien; in Japan, China und Korea ist der Trinkgeld-Block ausgeblendet |
| Freier Betrag | Der Gast gibt seinen eigenen Betrag ein |
| Standard-Trinkgeld | Nein — der Gast wählt selbst |
| Verteilung | Die Trinkgeld-Politik (direkt an den Kellner oder Pool nach geleisteten Stunden) wird im Bereich Personal → Gehalt festgelegt |
Wie der Gast das sieht#
Bei der Zahlung nach der Auswahl der Gerichte:
Ihre Bestellung: 45₾
Trinkgeld hinzufügen?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Anderer Betrag ]
[ Ohne Trinkgeld ]
GESAMT: 49.50₾ [Bezahlen →]
Trinkgeld-Berichte#
Bereich Finanzen:
- Tab „Übersicht“ — Gesamtsumme der Trinkgelder für den Zeitraum mit Vergleich zum vorherigen;
- Tab „Verkäufe“ — Trinkgelder aufgeschlüsselt nach Kellnern.
7. Auszahlungen auf Ihr Konto#
Wie Stripe das Geld auszahlt#
Der Gast bezahlt → Stripe behält ein → Nach T+2 Tagen → Geld auf Ihrem Konto
| Parameter | Wert |
|---|---|
| Standard-Auszahlung | T+2 (nach 2 Werktagen) |
| Beschleunigte Auszahlung | T+1 (in einigen Ländern verfügbar) |
| Sofort-Auszahlung | Instant Payouts (innerhalb einer Stunde, gegen zusätzliche Gebühr) |
| Mindest-Auszahlung | 1€ / 1$ / 1₾ |
Einrichten des Zeitplans#
Im Stripe Dashboard → Settings → Payouts:
- Täglich (empfohlen)
- Wöchentlich (konkreter Wochentag)
- Monatlich
8. Stripe-Gebühren#
| Region | Gebühr | Beispiel |
|---|---|---|
| Europa (EWR) | 1.5% + 0.25€ | Bestellung 50€ → Gebühr 1.00€ |
| Vereinigtes Königreich | 1.5% + 0.20£ | Bestellung £50 → Gebühr £0.95 |
| USA/Kanada | 2.9% + $0.30 | Bestellung $50 → Gebühr $1.75 |
| Internationale Karten | +1.5% | Zusätzlich für Karten aus einem anderen Land |
| Währungsumrechnung | +1% | Wenn die Währung der Karte ≠ der Währung des Kontos |
9. Rückerstattungen#
Die Rückerstattung von Geld über Stripe wird von zwei Stellen aus gestartet — je nachdem, wie die Bestellung abgewickelt wurde.
Rückerstattungen des Online-Shops (RMA)#
- Bereich Rückerstattungen → Karte des Antrags.
- Wählen Sie den Rückerstattungsmodus: auf die ursprüngliche Zahlungsmethode (Stripe), per Geschenkkarte (store credit) oder per Umtausch.
- Markieren Sie die Artikel (vollständige oder teilweise Rückerstattung) und entscheiden Sie, ob die Ware ins Lager zurückgeht.
- Das Geld geht direkt von der Seite aus; auf die Karte des Gastes gelangt es in der Regel innerhalb von 5–10 Werktagen.
Rückerstattungen an der Kasse#
Im POS wird die Rückerstattung per Beleg abgewickelt — vollständig oder teilweise, es gibt auch einen Umtausch mit Weiterverkauf. Die Kassenschicht muss dabei geöffnet sein.
In der Karte der Bestellung im Bereich Bestellungen sind die Badges der abgewickelten Rückerstattungen mit einem Link zum Antrag sichtbar.
10. Sicherheit#
PCI DSS#
- Cenaly speichert keine Kartendaten — alles wird von Stripe verarbeitet
- Stripe ist als PCI Level 1 zertifiziert (höchste Stufe)
- Kartendaten werden verschlüsselt und tokenisiert
3D Secure#
- Automatische 3D-Secure-Prüfung für EU-Karten (SCA/PSD2)
- Reduziert Betrug und Chargebacks
- Für den Gast: Bestätigung in der App der Bank
Radar (Betrugsschutz)#
Stripe Radar blockiert automatisch verdächtige Transaktionen:
- Ungewöhnliches Kaufmuster
- Karten von schwarzen Listen
- Geolokalisierungs-Anomalien
11. Testen#
Testen Sie vor der Aktivierung im Produktivbetrieb:
Stripe-Testkarten#
| Kartennummer | Ergebnis |
|---|---|
| 4242 4242 4242 4242 | Erfolgreiche Zahlung |
| 4000 0000 0000 3220 | 3D Secure |
| 4000 0000 0000 9995 | Abgelehnt (unzureichende Mittel) |
| 4000 0000 0000 0069 | Karte abgelaufen |
CVV: beliebige 3 Ziffern. Datum: beliebiges zukünftiges. ZIP: beliebige.
Wie man testet#
- Wählen Sie bei der Verbindung den Schalter „Testmodus“ (er ist bei jedem Anbieter anders).
- Verwenden Sie die Testschlüssel (pk_test_..., sk_test_...) — und den Webhook, der im selben Stripe-Testmodus erstellt wurde.
- Machen Sie eine Testbestellung → bezahlen Sie mit einer Testkarte.
- Prüfen Sie den Status der Bestellung im Bereich Bestellungen — er sollte „Bezahlt“ werden.
- Wenn alles funktioniert — verbinden Sie den Anbieter mit den Live-Schlüsseln im Modus „Live“ erneut.
12. Alternative Anbieter#
Für Länder ohne Stripe oder als Ergänzung – bereits zur Verbindung bereit:
| Anbieter | Länder | Beschreibung |
|---|---|---|
| PayPal | Fast die ganze Welt | Die größte Abdeckung im Verzeichnis |
| BOG iPay | 🇬🇪 Georgien | Bank of Georgia, in Georgien weit verbreitet |
| TBC Bank | 🇬🇪 Georgien | E-Commerce-Akquiring von TBC |
| Square | US, CA, GB, AU, JP, IE, FR, ES | Hosted-Zahlungsseite (Payment Links) |
| Airwallex | EWR, UK, APAC, Amerika, Israel | Multivaluta-Hosted-Zahlung |
| PayTabs | Saudi-Arabien, VAE, Ägypten, Kuwait, Oman, Jordanien, Bahrain, Katar | Golf und Naher Osten |
| iyzico | 🇹🇷 Türkei | Karten und Ratenzahlung (taksit); die Ratenzahlungsgebühr zahlt der Gast zusätzlich zum Bestellbetrag |
Weitere 94 Anbieter (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay u. a.) sind bereits in der Liste, werden aber grau angezeigt – die Integration wird noch getestet. Der vollständige Überblick – im Abschnitt Zahlung.
Verbindung eines beliebigen Anbieters: App Store → Kategorie „Finanzen“ → Anbieterkarte → „Einrichten“, oder wie gewohnt über Standorte → Standortkarte → Tab „Zahlungen“.
13. Häufige Fragen#
Wann erhalte ich das Geld?#
2 Werktage nach der Zahlung (T+2). Die erste Auszahlung kann 7–14 Tage dauern (bis Stripe das Konto verifiziert).
Der Gast möchte bar bezahlen – wie vorgehen?#
Die Methoden „bar“ und „Karte bei Erhalt“ sind immer verfügbar und erfordern keinen Zahlungsanbieter – der Gast wählt sie beim Checkout, und die Abrechnung führt der Kassierer durch. Stripe wird dabei nicht verwendet; der Beleg wird an der Kasse ausgestellt, wenn Sie eine Fiskal-Registrierkasse angeschlossen haben (siehe Fiskalisierung).
Kann ich sowohl Stripe als auch BOG iPay verbinden?#
Ja. Im Tab „Zahlungen“ können Sie mehrere Anbieter gleichzeitig aktivieren – beim Checkout sieht der Gast für jeden eine Schaltfläche, die mit dem Namen des Anbieters beschriftet ist.
Stripe hat das Konto gesperrt – was tun?#
- Prüfen Sie die E-Mail – Stripe sendet den Grund
- In der Regel ist eine zusätzliche Verifizierung erforderlich
- Wenden Sie sich an den Stripe Support: support.stripe.com
- Während der Sperrung können Sie einen alternativen Anbieter nutzen
Wie lässt sich die Gebühr minimieren?#
- Fördern Sie die Zahlung mit EU-Karten (1,5 % statt 2,9 %)
- Nutzen Sie SEPA für große Beträge (0,35 € fix)
- Bei großem Umsatz (>100K€/Monat) – fordern Sie bei Stripe einen individuellen Tarif an
14. Support#
- Stripe: support.stripe.com
- Cenaly: support@cenaly.com → Betreff „Stripe / Zahlung“
- Stripe Status: status.stripe.com (Prüfung der Funktionsfähigkeit)