Konfiguration

Installieren Sie Stripe Terminal und synchronisieren Sie die nativen Capacitor-Projekte.

npm install @capacitor-community/stripe-terminal
npx cap sync

Das Plugin ist @capacitor-community/stripe-terminal v8.3.0. Offizielle Demos:

• Tap to Pay / Internet / Bluetooth
• Apps on Devices

Plattformen und Verbindungstypen

discoverReaders erhält einen Wert aus TerminalConnectTypes. Die Unterstützung unterscheidet sich je nach Plattform.

Übergeben Sie auf jeder Plattform isTest: true an initialize, wenn Sie simulierte Lesegeräte für einen unterstützten Verbindungstyp verwenden möchten. Verlassen Sie sich unter iOS oder im Web nicht auf TerminalConnectTypes.Simulated; verwenden Sie stattdessen Internet, Bluetooth oder TapToPay mit isTest: true.

Im Web weist discoverReaders alle Typen außer Internet mit einem Fehler wegen Nichtverfügbarkeit zurück.

Plattformspezifische APIs

Die Einrichtungsreihenfolge und Einschränkungen finden Sie unter Tap to Pay.

Wirkungslose und nicht unterstützte Lebenszyklusmethoden im Web

Diese Methoden sind in der Plugin-Schnittstelle vorhanden, steuern im Web jedoch nicht das Stripe Terminal JS SDK:

• cancelDiscoverReaders — ohne Wirkung
• setSimulatorConfiguration — ohne Wirkung
• installAvailableUpdate — ohne Wirkung
• cancelInstallUpdate — ohne Wirkung
• rebootReader — ohne Wirkung
• cancelReaderReconnection — ohne Wirkung
• setTapToPayUxConfiguration — ohne Wirkung

isTapToPayAccountLinked löst im Web unavailable aus.

Internet-Lesegeräte im Web unterstützen weiterhin initialize, discoverReaders, connectReader, getConnectedReader, disconnectReader, collectPaymentMethod, cancelCollectPaymentMethod, confirmPaymentIntent, setReaderDisplay, clearReaderDisplay, setConnectionToken sowie die Listener für Verbindungs- und Zahlungsstatus.

Webkonfiguration

Es sind keine weiteren Schritte erforderlich. Nur Internet-Lesegeräte sind verfügbar.

iOS-Konfiguration

Für das Plugin sind keine weiteren Schritte erforderlich. USB, HandOff und setTapToPayUxConfiguration sind unter iOS nicht implementiert.

Android-Konfiguration

Fügen Sie Ihrem Dokument android/app/src/main/AndroidManifest.xml die Berechtigungen hinzu:

+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+ <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

discoverReaders wird abgewiesen, wenn ACCESS_FINE_LOCATION nicht zur Laufzeit erteilt wurde.

Setzen Sie außerdem minSdkVersion in Ihrer Datei android/variables.gradle auf 26:

  ext {
-    minSdkVersion = 24
+    minSdkVersion = 26
  }

Wenn Sie Apps für Stripe-Android-Geräte (etwa Stripe Reader S700) entwickeln und TerminalConnectTypes.HandOff verwenden, folgen Sie der Anleitung von Stripe zur clientseitigen Einrichtung.