Stripe Terminal-Gateway
Mit dem Stripe Terminal-Gateway können Vor-Ort-Zahlungen über Stripe Terminal-Hardware-Lesegeräte direkt in WCPOS angenommen werden. Dieses Gateway unterstützt sowohl physische Kartenlesegeräte als auch einen Simulatormodus für Tests.
Funktionen
Hardware-Integration
Physische Stripe Terminal-Lesegeräte über eine Internetverbindung verbinden
Simulatormodus
Zahlungen ohne Hardware mit dem Simulator von Stripe testen
Echtzeitverarbeitung
Sofortige Zahlungsabwicklung und Bestätigung
Sichere Transaktionen
PCI-konforme Zahlungsabwicklung über Stripe
Telefonbestellungen (MOTO)
Kartenzahlungen telefonisch akzeptieren, indem die Details in das Lesegerät eingegeben werden
Installation
Stripe Terminal for WooCommerce installieren
Installieren Sie es über WP Admin > POS > Einstellungen > Erweiterungen, oder laden Sie das aktuelle Plugin-Zip-Asset (nicht das GitHub-Quellcode-Zip oder -Tarball) von der GitHub-Releases-Seite herunter und laden Sie es über Plugins > Neu hinzufügen > Plugin hochladen hoch.
Stripe-Einstellungen konfigurieren
- Navigieren Sie zu
WP Admin > WooCommerce > Einstellungen > Zahlungen - Suchen Sie Stripe Terminal in der Liste der Zahlungsmethoden
- Klicken Sie auf Stripe Terminal, um die Einstellungen aufzurufen
- Geben Sie Ihren Stripe Secret Key ein (Sie erhalten diesen in Ihrem Stripe Dashboard)
- Speichern Sie die Einstellungen
Das Stripe Terminal-Gateway muss in den WooCommerce-Einstellungen nicht aktiviert werden. Es wird im nächsten Schritt speziell für den POS aktiviert.
In WCPOS aktivieren
- Zu
WP Admin > POS > Einstellungen > Checkoutgehen - Das Gateway Stripe Terminal in der Liste suchen
- Das Gateway für die Verwendung im POS aktivieren
- Einstellungen speichern
Verwendung
Lesegerät verbinden
Wenn das Stripe Terminal-Gateway während des Checkouts im POS ausgewählt wird:
- Verbindungsmethode wählen: Es kann entweder ein physisches Lesegerät verbunden oder der Simulator verwendet werden
- Physisches Lesegerät: Folgen Sie den Anweisungen auf dem Bildschirm, um Ihr Stripe Terminal-Gerät zu verbinden
- Simulator: Wählen Sie den Simulatormodus aus, um verschiedene Zahlungsszenarien ohne Hardware zu testen
Zahlungen verarbeiten
- Artikel hinzufügen: Fügen Sie Produkte zum Warenkorb im POS hinzu
- Gateway auswählen: Wählen Sie "Stripe Terminal" als Zahlungsmethode
- Lesegerät verbinden: Verbinden Sie Ihr Lesegerät oder wählen Sie den Simulatormodus
- Zahlung verarbeiten: Folgen Sie den Aufforderungen, um die Transaktion abzuschließen
- Bestätigung: Die Bestellung wird nach erfolgreicher Zahlung automatisch als abgeschlossen markiert
Testen mit dem Simulator
Mit dem Simulator können Sie verschiedene Zahlungsmethoden und Szenarien testen:
- Kartenzahlungen: Testen Sie verschiedene Kartentypen (Visa, Mastercard, etc.)
- Kontaktlose Zahlungen: Simulieren Sie kontaktlose Transaktionen
- Fehlerszenarien: Testen Sie abgelehnte Zahlungen und andere Fehlerbedingungen
- Unterschiedliche Beträge: Testen Sie verschiedene Transaktionsbeträge
Telefonbestellungen (MOTO)
Mit MOTO (Mail Order/Telephone Order) können Kartenzahlungen für Kunden verarbeitet werden, die nicht vor Ort sind, zum Beispiel bei der Annahme einer Bestellung per Telefon. Statt eine Karte aufzulegen oder einzustecken, gibt der Händler die Kartendaten direkt auf dem Bildschirm des Terminal-Lesegeräts ein.
Einrichtung
MOTO-Zugriff bei Stripe anfordern
MOTO ist standardmäßig nicht aktiviert. Wenden Sie sich an den Stripe-Support und bitten Sie darum, MOTO-Berechtigungen für Ihr Konto zu aktivieren. Dies ist ein schneller Vorgang, erfordert jedoch eine manuelle Freigabe durch Stripe.
In den Plugin-Einstellungen aktivieren
- Navigieren Sie zu
WP Admin > WooCommerce > Einstellungen > Zahlungen > Stripe Terminal - Aktivieren Sie das Kontrollkästchen Telefonbestellungen (MOTO)
- Speichern Sie die Einstellungen
Ein kompatibles Lesegerät verbinden
MOTO funktioniert nur mit kompatiblen, mit dem Internet verbundenen Lesegeräten, die unter Unterstützte Terminals aufgeführt sind. Der Umschalter wird für andere Lesegerätetypen nicht angezeigt.
Telefonische Bestellung aufnehmen
- Ein kompatibles Lesegerät verbinden (siehe Unterstützte Terminals)
- Auf dem Zahlungsbildschirm Telefonische Bestellung aktivieren
- Auf Kartenzahlung einziehen klicken — das Lesegerät zeigt einen Bildschirm zur Eingabe der Kartennummer an, anstatt zum Auflegen/Einstecken aufzufordern
- Kartennummer, Ablaufdatum und CVV des Kunden auf dem Lesegerät eingeben
- Die Zahlung wird anschließend wie gewohnt verarbeitet
MOTO-Zahlungen verwenden card als Zahlungsmethodentyp statt card_present. Das bedeutet, dass sie aus Sicht von Stripe eher wie Online-Transaktionen behandelt werden. Daher gelten die Standardgebühren für Online-Kartenverarbeitung und nicht die Vor-Ort-Gebühren.
Der Umschalter für telefonische Bestellungen wird nur angezeigt, wenn alle drei Bedingungen erfüllt sind: Die MOTO-Einstellung ist in den Plugin-Einstellungen aktiviert, ein kompatibles Lesegerät ist verbunden, und das Lesegerät ist kein Simulator. Wenn der Umschalter nicht angezeigt wird, prüfen Sie diese Bedingungen.
Anforderungen
Hardwarekompatibilität
Diese Implementierung verwendet das JavaScript SDK von Stripe. Das bedeutet, dass sie über Webanwendungen funktioniert, aber ausschließlich internetverbundene Terminals erfordert. Bluetooth-Terminals werden derzeit nicht unterstützt.
Unterstützte Terminals (internetverbunden)
- Stripe Reader S700/S710 ✅ - Terminal mit Ethernet-/WLAN-Verbindung
- WisePOS E ✅ - Terminal mit WLAN-Verbindung
Nicht unterstützte Terminals (Bluetooth)
- BBPOS Chipper 2X BT ❌ - nur Bluetooth
- BBPOS WisePad 3 ❌ - nur Bluetooth
- Verifone P400 ❌ - nur Bluetooth
Die Unterstützung für Bluetooth-Terminals ist für eine zukünftige Version der iOS- und Android-App geplant. Sobald sie verfügbar ist, wird damit die Unterstützung für alle von Stripe Terminal zertifizierten Lesegeräte möglich, einschließlich M2 und WisePad 3.
Häufige Probleme
Lesegerät stellt keine Verbindung her
- Stellen Sie sicher, dass Sie ein unterstütztes internetfähiges Terminal verwenden
- Prüfen Sie, ob das Terminal mit WLAN/Ethernet verbunden und online ist
- Prüfen Sie, ob Terminal in Ihrem Stripe-Konto aktiviert ist
- Bestätigen Sie, dass das Terminal in Ihrem Stripe-Dashboard registriert ist
Zahlung abgelehnt
- Prüfen Sie, ob Ihr Stripe-Konto aktiv ist und keine Einschränkungen vorliegen
- Prüfen Sie, ob die verwendete Karte gültig ist
- Stellen Sie sicher, dass ausreichendes Guthaben verfügbar ist
Umschalter für telefonische Bestellungen wird nicht angezeigt
- Prüfen Sie, ob die Einstellung Telefonische Bestellungen (MOTO) unter
WooCommerce > Einstellungen > Zahlungen > Stripe Terminalaktiviert ist - Stellen Sie sicher, dass eine Verbindung zu einem kompatiblen Lesegerät besteht (siehe Unterstützte Terminals) — der Umschalter ist für andere Lesegerätetypen ausgeblendet
- Der Umschalter wird bei Verwendung des Simulators nicht angezeigt
MOTO-Zahlung schlägt mit einem Fehler fehl
- Bestätigen Sie, dass Stripe MOTO-Berechtigungen für Ihr Konto aktiviert hat — kontaktieren Sie den Stripe Support, falls dies noch nicht geschehen ist
- Prüfen Sie nochmals, ob die Kartendaten auf dem Lesegerät korrekt eingegeben wurden
- Für MOTO-Zahlungen können strengere Betrugsprüfungen gelten — stellen Sie sicher, dass die Karte gültig ist und über ausreichendes Guthaben verfügt
SSL-Zertifikatfehler
- Stripe Terminal erfordert HTTPS - stellen Sie sicher, dass Ihre Website über ein gültiges SSL-Zertifikat verfügt
- Prüfen Sie, ob Ihr SSL-Zertifikat korrekt konfiguriert ist
Hilfe erhalten
Für technischen Support:
- Besuchen Sie das GitHub-Repository, um Probleme zu melden
- Lesen Sie die Stripe Terminal-Dokumentation für hardwarespezifische Hinweise
- Wenden Sie sich bei kontobezogenen Problemen an den Stripe-Support
Screenshots
Screenshots werden in einem zukünftigen Update hinzugefügt und zeigen:
- Gateway-Konfiguration in den WooCommerce-Zahlungseinstellungen
- POS-Checkout-Oberfläche mit Stripe Terminal-Auswahl
- Simulator-Testoberfläche mit verschiedenen Zahlungsmethoden