Stripe fuer PL- und DE-Shops einrichten: der komplette Praxis-Leitfaden

Ein Stripe-Konto bedient DE- und PL-Shop sowie mehrere Waehrungen
Testschluessel (pk_test, sk_test) zum Pruefen, Live (pk_live, sk_live) fuer die Produktion
Der Webhook ist Voraussetzung fuer den automatischen Bestellstatus
Karten, Apple Pay, Google Pay und ueber Stripe auch Klarna und BLIK
Die Gebuehr fuer europaeische Karten startet bei rund 1,5 Prozent plus Fixbetrag
3D Secure und SCA sind in der EU Pflicht, Stripe regelt sie automatisch
[/dwb_keytakeaways]

Warum Stripe fuer einen Shop auf zwei Maerkten

Stripe ist der weltweite Standard fuer Online-Zahlungen und spielt seine Staerke dort aus, wo du auf mehr als einem Markt verkaufst. In einer Integration bekommst du internationale Karten, Apple Pay und Google Pay, und ueber den Mechanismus der Zahlarten auch Klarna und BLIK. Fuer einen Shop, der gleichzeitig Deutschland und Polen anvisiert, ist das praktisch, weil du nicht mit getrennten Anbietern pro Land jonglierst.

Die Erwartung sollte aber gleich klar sein. In einem deutschen Shop ist Stripe eine starke Basis, viele Haendler ergaenzen jedoch SEPA-Lastschrift und PayPal, weil Ueberweisung und PayPal in Deutschland tief verankert sind. In einem rein polnischen Shop ersetzt Stripe keinen lokalen Anbieter vollstaendig, da es polnische Sofortueberweisungen nicht in der Form von Przelewy24 oder PayU bietet. Geht es um Deutschland und die uebrige EU, ist Stripe als Fundament sinnvoll, denn Karten und Klarna sind dort die erste Wahl.

In diesem Leitfaden gehe ich durch die gesamte Einrichtung: Konto anlegen und verifizieren, API-Schluessel, Test- und Live-Modus, Webhooks, Auswahl der Zahlarten, Gebuehren, 3D Secure unter SCA, Waehrungsumrechnung, Auszahlungen und die haeufigsten Fehler, die spaeter Chaos in den Bestellungen erzeugen.

Konto anlegen und Firma verifizieren

Das Stripe-Konto legst du auf stripe.com an, mit den Daten der Firma aus dem Land, in dem sie registriert ist. Eine deutsche GmbH legt das Konto in Deutschland an, eine polnische Gesellschaft in Polen. Ein Konto bedient den Verkauf in mehreren Laendern und Waehrungen, getrennte Konten fuer DE und PL brauchst du also nicht, solange du einen Rechtstraeger hast.

Nach der Registrierung verlangt Stripe Daten zur Verifizierung der Firma (KYC-Prozess, also Know Your Customer). Das ist gesetzlich vorgeschrieben und laesst sich nicht ueberspringen.

• Firmendaten: Name, Adresse, Registernummer (Handelsregisternummer und USt-IdNr in Deutschland).
• Daten der Inhaber und Geschaeftsfuehrer: Name, Geburtsdatum, teils ein Ausweisdokument.
• Bankverbindung: auf dieses Konto zahlt Stripe die Betraege aus, am besten ein Geschaeftskonto in der Auszahlungswaehrung.
• Beschreibung der Taetigkeit: was du verkaufst, da Stripe das Risiko der Branche bewertet.

Die Verifizierung dauert meist von wenigen Minuten bis zu zwei Werktagen. Bis sie abgeschlossen ist, kannst du im Testmodus arbeiten, du musst also mit der Einrichtung des Shops nicht warten.

API-Schluessel: Test und Live

Stripe kommuniziert mit dem Shop ueber API-Schluessel. Jedes Konto hat zwei Saetze, und diese Unterscheidung ist der Kern einer sicheren Einrichtung.

• Oeffentlicher Schluessel (beginnt mit pk_): wird im Browser verwendet, sicher zum Anzeigen.
• Geheimer Schluessel (beginnt mit sk_): wird auf dem Server verwendet, gehoert nie in Code im Repository oder oeffentlich sichtbar.

Dazu kommt die Unterscheidung der Umgebung. Testschluessel tragen test im Namen (pk_test, sk_test), Produktivschluessel live (pk_live, sk_live). Die Schluessel findest du im Stripe-Dashboard unter Developers im Reiter API keys. Im offiziellen Stripe-Plugin fuer WooCommerce traegst du beide Saetze in die passenden Felder ein, ein Umschalter entscheidet, welcher aktiv ist.

Die wichtigste Regel: Der geheime Live-Schluessel ist so sensibel wie ein Bankpasswort. Trage ihn nicht in Dateien ein, die ins Repository committet werden, und verschicke ihn nicht im Klartext per Mail. In der Produktion gehoert er in die Plugin-Einstellungen oder in eine Umgebungsvariable auf dem Server.

Testmodus: bevor es um echtes Geld geht

Der Testmodus ist der Grund, warum die Einrichtung von Stripe sicher ist. Mit Testschluesseln klickst du den ganzen Bestellablauf wie ein Kunde durch, ohne echtes Geld zu bewegen. Stripe stellt Testkartennummern bereit, die verschiedene Szenarien simulieren.

1. Erfolgreiche Karte: Nummer 4242 4242 4242 4242 mit beliebigem Datum in der Zukunft und beliebigem CVC, die Zahlung geht durch.
2. Karte mit 3D Secure: eigene Testnummern erzwingen den Authentifizierungsschritt, du pruefst den SCA-Ablauf.
3. Abgelehnte Karte: eine auf 0002 endende Nummer gibt eine Ablehnung zurueck, du pruefst die Fehlermeldung fuer den Kunden.

Klicke im Testmodus eine Bestellung durch, pruefe, ob der Status in WooCommerce auf bezahlt wechselt, ob die Bestaetigungsmail rausgeht und ob die Bestellung im Stripe-Dashboard erscheint. Erst wenn das laeuft, schaltest du auf Live.

Webhooks: das Herz der Automatisierung

Ein Webhook ist eine Adresse in deinem Shop, an die Stripe eine Benachrichtigung ueber ein Ereignis schickt, etwa ueber eine erfolgreiche Zahlung. Ohne funktionierenden Webhook kommt das Geld an, aber der Shop weiss nichts von der Bezahlung, der Status wechselt also nicht automatisch. Das ist die haeufigste Quelle fuer Chaos in den Bestellungen, die ich bei schlecht eingerichtetem Stripe sehe.

Den Webhook konfigurierst du im Stripe-Dashboard unter Developers im Reiter Webhooks. Du legst einen Endpoint an, also die Shop-Adresse (sie gibt meist das offizielle Plugin vor), und waehlst die Ereignisse zum Mithoeren. Stripe erzeugt ein Webhook-Secret (beginnt mit whsec_), das du in die Plugin-Einstellungen einfuegst, damit der Shop die Echtheit der Benachrichtigungen prueft.

Zahlarten: Karten, Wallets, Klarna, BLIK

Die Staerke von Stripe ist der Mechanismus Payment Methods: ein Konto, und die Methoden aktivierst du im Dashboard je nach Markt und Waehrung. Fuer einen DE- und PL-Shop lohnt es, den Satz pro Land zu durchdenken.

• Karten (Visa, Mastercard): Basis auf beiden Maerkten, funktionieren in EUR und PLN.
• Apple Pay und Google Pay: Zahlung mit einem Fingertipp, heben die Conversion am Handy deutlich. Sie verlangen eine Domain-Verifizierung im Stripe-Dashboard.
• Klarna: Kauf auf Rechnung beziehungsweise spaeter zahlen. In Deutschland fuer einen grossen Teil der Kunden die erste Wahl, ueber Stripe ohne separaten Vertrag mit Klarna.
• BLIK: im polnischen Shop die Methode Nummer eins. Stripe unterstuetzt BLIK fuer Transaktionen in PLN, du aktivierst es in den Zahlarten.

Fuer den deutschen Shop ist der uebliche Satz Karten, Apple Pay, Google Pay und Klarna, oft ergaenzt um SEPA-Lastschrift und PayPal. Fuer den polnischen: Karten, BLIK, Apple Pay, Google Pay und haeufig Klarna, dazu ein lokaler Anbieter fuer Sofortueberweisungen. Teste nach dem Aktivieren jeder Methode, da die Verfuegbarkeit von Land des Kontos und Waehrung abhaengt.

Gebuehren, 3D Secure und Waehrungsumrechnung

Der Kosten von Stripe besteht vor allem aus der Transaktionsgebuehr, denn es gibt keine Grundgebuehr und keine Einrichtungsgebuehr. Die Saetze unterscheiden sich nach Herkunft der Karte und Waehrung.

1. Europaeische Karten: die Gebuehr startet meist bei rund 1,5 Prozent plus einem festen Betrag von etwa 25 Cent pro Transaktion.
2. Karten ausserhalb Europas: hoeher, meist etwa 2,5 bis 3,3 Prozent plus Fixbetrag, da sie mit groesserem Risiko und Kosten verbunden sind.
3. Waehrungsumrechnung: zahlt der Kunde in einer anderen Waehrung als deiner Auszahlungswaehrung, schlaegt Stripe einen Aufschlag fuer die Umrechnung auf, meist rund 2 Prozent.

Das sind Richtwerte, nimm sie als Ausgangspunkt. Die echten Kosten haengen von Preismodell, Volumen und Vereinbarung ab, bei hohem Umsatz lohnt die Frage nach individuellen Saetzen.

Ein eigenes Thema ist die Sicherheit der Zahlung. In der EU gilt SCA (starke Kundenauthentifizierung), was in der Praxis 3D Secure bedeutet: Der Kunde bestaetigt die Zahlung in der Bank-App oder per Code. Die gute Nachricht ist, dass Stripe das automatisch regelt und selbst entscheidet, wann eine Authentifizierung noetig ist. Du musst das nicht programmieren, aber du musst den Ablauf mit einer Testkarte fuer 3D Secure pruefen, damit der Bildschirm der Bank korrekt erscheint.

Auszahlungen

Stripe ueberweist das Geld nicht sofort auf dein Konto. Die Betraege landen zuerst im Stripe-Saldo und werden von dort nach einem festgelegten Zeitplan auf das Bankkonto ausgezahlt. Standardmaessig sind die Auszahlungen automatisch und kommen mit einigen Werktagen Verzoegerung, die auf einem neuen Konto laenger ausfaellt und sich danach verkuerzt.

Den Auszahlungsplan stellst du im Stripe-Dashboard ein: taeglich, woechentlich oder monatlich. Du kannst auch auf manuelle Auszahlungen wechseln, wenn du den Zeitpunkt voll kontrollieren willst. Bei einem Shop auf zwei Maerkten und mit mehreren Waehrungen kann Stripe in der Saldo-Waehrung auszahlen, ein Bankkonto in EUR ist also ohnehin gesetzt, wenn du viel in Deutschland verkaufst, um doppelte Umrechnung zu vermeiden.

Die haeufigsten Fehler bei der Einrichtung

Nach vielen Projekten zeigt sich, dass die Probleme an denselben Stellen wiederkehren. Hier die Checkliste, die ich vor der Uebergabe eines Shops mit Stripe durchgehe.

Drei Fehler verursachen die meisten Tickets. Der erste ist ein auf der Produktion vergessener Testmodus, sodass echte Zahlungen gar nicht ankommen. Der zweite ist ein fehlender Live-Webhook, sodass die Zahlung durchgeht, die Bestellung aber unbezahlt bleibt. Der dritte ist ein geheimer Live-Schluessel an der falschen Stelle, etwa in einer ins Repository committeten Datei, was ein echtes Sicherheitsrisiko ist. Alle drei sind leicht zu uebersehen und alle drei leicht zu beheben, wenn du weisst, wo du hinschauen musst.

Wenn du einen Shop fuer Deutschland und Polen aufbaust oder eine bestehende Stripe-Integration aufraeumen willst, mache ich das bei DawidWeb regelmaessig: Konto und Zahlarten fuer beide Maerkte konfigurieren, korrekte Webhooks, 3D-Secure-Tests und die Anbindung von Klarna und BLIK, damit sich die Bestellungen selbst verbuchen. Webseiten und Shops baue ich ab 600 EUR, ich bin Shoper-Partner, habe ueber 120 Projekte umgesetzt, und ein Angebot fuer deine konkrete Umsetzung bekommst du innerhalb von 24 Stunden.