# 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[​](#features "Direkter Link zu 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[​](#installation "Direkter Link zu Installation") 1 #### 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](https://github.com/wcpos/stripe-terminal-for-woocommerce/releases) herunter und laden Sie es über `Plugins > Neu hinzufügen > Plugin hochladen` hoch. 2 #### Stripe-Einstellungen konfigurieren 1. Navigieren Sie zu `WP Admin > WooCommerce > Einstellungen > Zahlungen` 2. Suchen Sie **Stripe Terminal** in der Liste der Zahlungsmethoden 3. Klicken Sie auf **Stripe Terminal**, um die Einstellungen aufzurufen 4. Geben Sie Ihren **Stripe Secret Key** ein (Sie erhalten diesen in Ihrem Stripe Dashboard) 5. Speichern Sie die Einstellungen Hinweis Das Stripe Terminal-Gateway muss in den WooCommerce-Einstellungen nicht aktiviert werden. Es wird im nächsten Schritt speziell für den POS aktiviert. 3 #### In WCPOS aktivieren 1. Zu `WP Admin > POS > Einstellungen > Checkout` gehen 2. Das Gateway **Stripe Terminal** in der Liste suchen 3. Das Gateway für die Verwendung im POS aktivieren 4. Einstellungen speichern ## Verwendung[​](#usage "Direkter Link zu Verwendung") ### Lesegerät verbinden[​](#connecting-a-reader "Direkter Link zu Lesegerät verbinden") Wenn das Stripe Terminal-Gateway während des Checkouts im POS ausgewählt wird: 1. **Verbindungsmethode wählen**: Es kann entweder ein physisches Lesegerät verbunden oder der Simulator verwendet werden 2. **Physisches Lesegerät**: Folgen Sie den Anweisungen auf dem Bildschirm, um Ihr Stripe Terminal-Gerät zu verbinden 3. **Simulator**: Wählen Sie den Simulatormodus aus, um verschiedene Zahlungsszenarien ohne Hardware zu testen ### Zahlungen verarbeiten[​](#processing-payments "Direkter Link zu Zahlungen verarbeiten") 1. **Artikel hinzufügen**: Fügen Sie Produkte zum Warenkorb im POS hinzu 2. **Gateway auswählen**: Wählen Sie "Stripe Terminal" als Zahlungsmethode 3. **Lesegerät verbinden**: Verbinden Sie Ihr Lesegerät oder wählen Sie den Simulatormodus 4. **Zahlung verarbeiten**: Folgen Sie den Aufforderungen, um die Transaktion abzuschließen 5. **Bestätigung**: Die Bestellung wird nach erfolgreicher Zahlung automatisch als abgeschlossen markiert ### Testen mit dem Simulator[​](#testing-with-simulator "Direkter Link zu 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)[​](#phone-orders-moto "Direkter Link zu 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[​](#setup "Direkter Link zu Einrichtung") 1 #### MOTO-Zugriff bei Stripe anfordern MOTO ist standardmäßig nicht aktiviert. Wenden Sie sich an den [Stripe-Support](https://support.stripe.com/contact) und bitten Sie darum, MOTO-Berechtigungen für Ihr Konto zu aktivieren. Dies ist ein schneller Vorgang, erfordert jedoch eine manuelle Freigabe durch Stripe. 2 #### In den Plugin-Einstellungen aktivieren 1. Navigieren Sie zu `WP Admin > WooCommerce > Einstellungen > Zahlungen > Stripe Terminal` 2. Aktivieren Sie das Kontrollkästchen **Telefonbestellungen (MOTO)** 3. Speichern Sie die Einstellungen 3 #### Ein kompatibles Lesegerät verbinden MOTO funktioniert nur mit kompatiblen, mit dem Internet verbundenen Lesegeräten, die unter [Unterstützte Terminals](#supported-terminals-internet-connected) aufgeführt sind. Der Umschalter wird für andere Lesegerätetypen nicht angezeigt. #### Telefonische Bestellung aufnehmen[​](#taking-a-phone-order "Direkter Link zu Telefonische Bestellung aufnehmen") 1. Ein kompatibles Lesegerät verbinden (siehe [Unterstützte Terminals](#supported-terminals-internet-connected)) 2. Auf dem Zahlungsbildschirm **Telefonische Bestellung** aktivieren 3. Auf **Kartenzahlung einziehen** klicken — das Lesegerät zeigt einen Bildschirm zur Eingabe der Kartennummer an, anstatt zum Auflegen/Einstecken aufzufordern 4. Kartennummer, Ablaufdatum und CVV des Kunden auf dem Lesegerät eingeben 5. Die Zahlung wird anschließend wie gewohnt verarbeitet Tipp 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. Vorsicht 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[​](#requirements "Direkter Link zu Anforderungen") Stripe-Konto : Aktives Stripe-Konto mit aktiviertem Terminal API-Schlüssel : Geheimer Stripe-Schlüssel aus Ihrem Dashboard WCPOS : Pro-Version für den POS-Checkout erforderlich HTTPS : Ihre Website muss aus Sicherheitsgründen SSL/HTTPS verwenden ## Hardwarekompatibilität[​](#hardware-compatibility "Direkter Link zu Hardwarekompatibilität") Verbindungsanforderungen 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)[​](#supported-terminals-internet-connected "Direkter Link zu Unterstützte Terminals (internetverbunden)") * **Stripe Reader S700/S710** ✅ - Terminal mit Ethernet-/WLAN-Verbindung * **WisePOS E** ✅ - Terminal mit WLAN-Verbindung ### Nicht unterstützte Terminals (Bluetooth)[​](#unsupported-terminals-bluetooth "Direkter Link zu Nicht unterstützte Terminals (Bluetooth)") * **BBPOS Chipper 2X BT** ❌ - nur Bluetooth * **BBPOS WisePad 3** ❌ - nur Bluetooth * **Verifone P400** ❌ - nur Bluetooth Zukünftige Unterstützung 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[​](#common-issues "Direkter Link zu Häufige Probleme") Lesegerät stellt keine Verbindung her * Stellen Sie sicher, dass Sie ein [unterstütztes internetfähiges Terminal](#supported-terminals-internet-connected) 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 Terminal` aktiviert ist * Stellen Sie sicher, dass eine Verbindung zu einem kompatiblen Lesegerät besteht (siehe [Unterstützte Terminals](#supported-terminals-internet-connected)) — 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](https://support.stripe.com/contact), 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[​](#getting-help "Direkter Link zu Hilfe erhalten") Für technischen Support: * Besuchen Sie das [GitHub-Repository](https://github.com/wcpos/stripe-terminal-for-woocommerce), um Probleme zu melden * Lesen Sie die [Stripe Terminal-Dokumentation](https://stripe.com/docs/terminal) für hardwarespezifische Hinweise * Wenden Sie sich bei kontobezogenen Problemen an den Stripe-Support ## Screenshots[​](#screenshots "Direkter Link zu 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