Stripe- und PayPal-Zahlung im Webshop

Zielgruppe: Chef, Büro (Einrichtung/Pflege) — Gast nutzt die Zahlung im Checkout
Typische Nutzung: Einmalig beim Einrichten, im Alltag für Refunds/Stornos und monatliche Abstimmung
Aufruf: my.smorder.at → Payment → App-/Web-Payment sowie my.smorder.at → Bestellungen (für Refund/Storno)

Zweck

Stripe und PayPal sind die beiden Standard-Online-Zahlungsmittel im Smorder-Webshop. Stripe deckt Kredit- und Debitkarten (Visa, Mastercard, American Express, Maestro), Apple Pay, Google Pay und je nach Land zusätzliche Methoden wie SOFORT/Klarna oder EPS ab. PayPal kommt zusätzlich, weil ein relevanter Teil der Gäste (besonders in Deutschland) PayPal gegenüber Kartenzahlung bevorzugt. Für den Betrieb sind beide Wege getrennt: eigene Vertragspartner, eigene Auszahlungen, eigene Gebührenstruktur — aber dieselbe Oberfläche im Smorder-Backoffice.

Ablauf Einrichtung

Stripe

Stripe wird als Marktplatz-Integration („Connect") über APRO betrieben: APRO ist die Plattform, der Betrieb ist ein angebundenes Konto. Der initiale Anlageschritt läuft immer in Abstimmung mit APRO:

1. Unterlagen bereitstellen — Unternehmensname, Anschrift, IBAN, Passkopie der Eigentümer mit mehr als 25 % Beteiligung, Firmenbuch- bzw. Gewerberegisterauszug. APRO meldet den Betrieb im Stripe-Dashboard als neues Konto an.
2. Stripe-Assistent durchlaufen — Eingabe der Unternehmensdaten, IBAN, Inhaberdaten.
3. Konto-ID in Smorder hinterlegen — im Payment-Bereich wird die Stripe-Konto-ID mit dem Lokal verknüpft.
4. Zahlungsmittel aktivieren — pro lizenzierter Methode (Kreditkarte, SOFORT, Apple Pay, Google Pay) eine eigene Option. Jede Option lässt sich sichtbar/unsichtbar stellen.
5. Auszahlungs-Report einrichten — ein Zahlungsbericht mit Empfänger-E-Mail und Intervall (täglich/wöchentlich/monatlich) sorgt für automatische Reports an die Buchhaltung.
6. Testmodus ausschalten — nach dem Test mit dem Stripe-Sandbox-Konto auf Live-Modus umstellen und nochmals einen Echt-Ablauf testen.

PayPal

PayPal-Zugangsdaten müssen aus einem bestehenden PayPal-Business-Account kommen. Der Betrieb legt selbst eine App an und übermittelt die Zugangsdaten; Smorder speichert sie im Payment-Bereich:

1. PayPal-Business-Account anlegen oder nutzen — falls nicht vorhanden, zunächst über paypal.com ein Business-Konto eröffnen.
2. App bei PayPal Developer registrieren — im PayPal-Developer-Dashboard unter „Apps & Credentials" → „Live" eine neue App anlegen. Als App-Name den Namen des Betriebs verwenden.
3. Client ID und Secret kopieren — aus der neu angelegten App.
4. In Smorder eintragen — im Backoffice unter Payment → App-/Web-Payment eine neue Option vom Typ „PayPal" anlegen und Client ID und Secret einfügen.
5. Sichtbar stellen und testen — Checkout einmal live durchlaufen, bis eine Echtzahlung im PayPal-Konto des Betriebs ankommt.

Ablauf Zahlung (Gast)

1. Gast bestellt und kommt in den Checkout.
2. Zahlungsmittel wählen — Karte (Stripe), PayPal oder Gutschein.
3. Zahlung abschließen — bei Karte: Kartendaten eingeben oder Apple Pay/Google Pay bestätigen. Bei PayPal: Weiterleitung zu PayPal, Anmeldung dort, Bestätigung, Rücksprung zu Smorder.
4. Bestellung geht in die Kasse — mit dem passenden online-Zahlungsmittel („Smorder Kreditkarte", „Smorder PayPal", „Smorder SOFORT", je nach Methode).
5. Bestätigung per E-Mail an den Gast.
6. Auszahlung — Stripe und PayPal zahlen nach ihren Intervallen auf das Bankkonto des Betriebs aus (Stripe täglich/wöchentlich konfigurierbar, PayPal manuell oder automatisch).

Einstellungen

• Aktive Zahlungsmethoden pro Lokal — pro Betrieb einzeln, sodass z. B. ein Lokal nur Karte und PayPal, ein anderes zusätzlich SOFORT bekommt.
• Sichtbarkeit einzelner Methoden — eine Methode lässt sich ausblenden, ohne sie zu löschen (z. B. Apple Pay saisonal ausschalten).
• Auszahlungs-Reports — E-Mail-Adresse und Intervall. Empfohlen: monatlich an die Buchhaltung zur Abstimmung.
• Zahlungsmittel in der Kasse — pro Online-Methode ein eigenes Kassen-Zahlungsmittel (z. B. „Smorder Kreditkarte"), damit die Auswertung sauber getrennt ist. Die Zahlungsmittel-IDs werden zusätzlich im Smorder-Backoffice beim TPS-User hinterlegt, damit die Kassa die Online-Zahlung korrekt verbucht.
• Währung — wird am Lokal gesetzt und gilt für beide Zahlungsarten.
• Trinkgeld online — erlaubt oder nicht; siehe preorder-takeaway-delivery.md.
• Mindestbetrag für Kartenzahlung — optional, z. B. „Karte erst ab 5 €".

Berechtigungen

Ablauf Refund (Stripe)

1. Bestellung finden — im Smorder-Backoffice die Bestellung öffnen.
2. „Rückabwicklung via Stripe" starten — nur für Admin-Rollen verfügbar.
3. Zahlung auswählen — bei mehreren Zahlungen wird diejenige gewählt, die refundiert werden soll.
4. Beträge bestätigen — ein Teil-Refund ist durch Änderung des Betrags möglich; Gebühren werden je nach Stripe-Vertrag mit erstattet oder behalten.
5. Grund und Meldung eingeben — für Revision und Kundenkommunikation.
6. Refund auslösen — der Betrag geht je nach Zahlungsmethode in 2–10 Tagen an den Gast zurück. Bei SOFORT-Zahlungen erst 3–4 Tage nach der Original-Zahlung möglich.

Ablauf Refund/Storno (PayPal)

1. Im Smorder-Backoffice die Bestellung öffnen und die PayPal-Zahlung auswählen.
2. Refund auslösen — voller oder Teil-Refund. Alternativ direkt im PayPal-Business-Account unter „Aktivitäten" → Transaktion → „Zahlung erstatten".
3. Stornierung einer noch nicht abgeschlossenen Zahlung — bei PayPal im Status „autorisiert" kann die Zahlung storniert werden, bevor sie abgebucht wird.
4. Im Kassensystem — den Tisch/Bon entsprechend stornieren, damit Umsatz und Zahlungsmittel in Einklang bleiben.

Varianten

• Nur Stripe aktiv — Betrieb entscheidet sich gegen PayPal, um nur einen Vertragspartner zu pflegen. Typisch für B2B-lastige Kundschaft.
• Nur PayPal aktiv — Betrieb ohne Stripe-Vertrag, nutzt PayPal auch für Karten (PayPal verarbeitet Karten im Hintergrund mit).
• Beides parallel — Standardempfehlung bei gemischter Kundschaft, führt erfahrungsgemäß zur höchsten Conversion.
• Apple Pay / Google Pay — laufen über den bestehenden Stripe-Vertrag, werden nur zusätzlich freigeschaltet.
• SOFORT / Klarna / EPS — landesspezifisch über Stripe. Pro Methode eine eigene Sichtbarkeit.
• Barzahlung zusätzlich (nur bei Abholung oder Lieferung) — „Zahlung bei Abholung" bzw. „Zahlung an den Fahrer" als zusätzliche Option neben Stripe/PayPal.

Problembehebung

• „Karte wird nicht akzeptiert" → meist Bank-seitige 3-D-Secure-Abfrage, die der Gast bestätigen muss. Wenn sofort rot: Kartenlimit, Gültigkeit oder Kartenart prüfen.
• „PayPal-Weiterleitung kommt nicht zurück" → PayPal-App des Gastes blockiert den Rücksprung. Alternative Bezahlung im Browser.
• „Client ID ungültig" bei PayPal → Kommt meistens von einer Sandbox-App statt einer Live-App. In PayPal-Developer unter „Live" statt „Sandbox" eine neue App anlegen.
• „Refund schlägt fehl" → Bei SOFORT gilt die 3-4-Tage-Sperre nach Zahlung. Bei älteren Bestellungen (über 180 Tage) verweist Stripe auf Überweisung.
• „Auszahlung kommt nicht am Bankkonto an" — Stripe-Dashboard prüfen: steht die Auszahlung auf „ausstehend" wegen Bank-Feiertag oder Dokumenten-Nachforderung? Ggf. Stripe-Compliance-Meldung im Dashboard öffnen.
• „Zahlungsmittel in der Kasse doppelt" → passiert, wenn für eine Stripe-Methode zwei Kassen-Zahlungsmittel angelegt sind. Eines inaktiv setzen und die Zahlungsmittel-ID im Smorder-TPS-User korrigieren.
• „Bestellung bezahlt, in Kasse aber als offen" → Smorder-Service oder OrderService prüfen (läuft der Dienst auf der Server-Kasse?). Bei wiederholtem Auftreten Support.

Siehe auch

• preorder-takeaway-delivery.md — Welcher Flow nutzt welche Zahlungsarten
• online-gutschein-einloesung.md — Gutschein plus Stripe/PayPal als Restzahlung
• webshop-einrichtung.md — Reihenfolge der Einrichtung (Payment kommt nach Lokal-Stammdaten)
• ../myapro/online-reports.md — Abstimmung der Online-Umsätze mit dem Tagesabschluss
• ../uebergreifend/fibu-ablauf.md — Zahlungsmittel-Konten für die Buchhaltung
• Schnittstellen-Doku (für Techniker): docs/schnittstellen/articles/zahlungsterminals/