Apps on Devices
Verwenden Sie „Apps auf Geräten“, um Ihre Point-of-Sale (POS)-Anwendung zusammen mit anderen Apps auf Ihrem Gerät auszuführen. Sie können Ihre POS-App auf intelligenten Stripe-Lesegeräten bereitstellen, um eine All-in-One-Lösung zu liefern, oder eine kundenorientierte App für Zahlungen erstellen, die von Ihrem POS auf einem anderen Gerät ausgeführt wird.
Stripe wickelt alle Zahlungen und die Einhaltung der Vorschriften mit dem Stripe Terminal Android SDK ab.
„Apps auf Geräten“ ermöglicht die wichtigsten Phasen des Lebenszyklus Ihrer Anwendungen:
- App erstellen und testen
- App zur Überprüfung vorbereiten
- App übermitteln
- App auf ausgewählten Geräten bereitstellen
- Bereitstellung überwachen
Sehen Sie sich die Beispiel-App an, sich über Best Practices für die Integration, den Einzug und die Bestätigung einer Zahlung und vieles mehr zu informieren.
Unterstützte Integrationen
„Apps auf Geräten“ unterstützt zwei Arten von Integrationen:
- POS-Android-App auf einem intelligenten Stripe-Lesegerät
- POS-Android-App in Verbindung mit einer verbraucherorientierten App auf einem intelligenten Stripe-Lesegerät
Point-of-Sale-App auf einem intelligenten Stripe-Lesegerät
Bei dieser Integration werden sowohl Ihre POS-App als auch die Stripe Reader-App auf einem intelligenten Stripe-Lesegerät ausgeführt. Wenn das Gerät startet, startet es Ihre POS-App anstelle der Stripe Reader-App. Wenn Sie eine Transaktion initiieren, wird die Stripe Reader-App zur primären App. Am Ende der Transaktion wird die Stripe Reader-App beendet und Ihre POS-App wird zur primären App.
Point-of-Sale-App in Verbindung mit einer verbraucherorientierten App auf einem intelligenten Stripe-Lesegerät
Bei dieser Integration wird Ihre POS-App auf einem Gerät ausgeführt, das vom intelligenten Stripe-Lesegerät getrennt ist. Ihre verbraucherorientierte Android-App wird auf dem intelligenten Lesegerät von Stripe ausgeführt und unterstützt die Zahlungstransaktion.
Sie verwalten die Kommunikation zwischen Ihrer POS-App und der verbraucherorientierten App über TCP/IP.
App-Anforderungen
App-Ressourcen sind durch die Gerätespezifikationen beschränkt und die App-Funktionalität kann durch Unterschiede zur standardmäßigen Android-Entwicklung eingeschränkt sein. Stellen Sie sicher, dass Ihre App erfolgreich ausgeführt werden kann, indem Sie die folgenden Anforderungen erfüllen.
APK-Größenbeschränkung
APK-Dateien, die Sie in die Stripe API hochladen, haben eine Größenbeschränkung von 100 MB.
Gerätespezifikationen
Der Stripe Reader S700 verfügt über die folgenden Hardware-Spezifikationen:
CPU | Qualcomm Snapdragon 665 QCM6125 |
RAM | 4 GB |
Speicher | 64 GB |
Betriebssystem | Android 10 |
Bildschirmmaße | 1080x1920 Pixel |
Pixeldichte auf dem Bildschirm | 420 dpi (xxhdpi) |
Gerätespeicher
Stripe führt Over-the-Air-Updates (OTA-Updates) für alle Apps und Softwarekomponenten aus, die auf dem Gerät ausgeführt werden. Stellen Sie sicher, dass Ihre App höchstens 8 GB Speicherplatz auf dem Gerät belegt.
Unterschiede zum Standard-Android
Das Stripe SmartPOS-Betriebssystem ist auf Sicherheit und PCI-Konformität ausgelegt und basiert auf dem Android Open Source Project (AOSP). Es unterscheidet sich auf folgende Weise von einem Standard-Android-Erlebnis für Verbraucher/innen:
- Die Google Play-Dienste sind auf Stripe-Android-Geräten nicht verfügbar. Sie können SDKs der Google Play-Dienste in Ihre App integrieren, müssen jedoch überprüfen, ob Ihre App wie erwartet funktioniert. Beispielsweise funktionieren Teile der Firebase- und Google Maps SDKs auf Stripe-Geräten nicht.
- Benachrichtigungen sind deaktiviert und der/die Nutzer/in des Geräts kann nicht auf den Startbildschirm zugreifen. Entweder Ihre App oder die Stripe Reader-App bleibt die primäre App.
- Produktionsgeräte haben einen deaktivierten USB-Anschluss. Darüber hinaus sind Android Debug Bridge (
adb
) und Debugging nicht verfügbar.
Sie können ein DevKit-Gerät für Entwicklungszwecke verwenden.
Android-Berechtigungen
Während der Installation gewährt das Stripe SmartPOS-Betriebssystem automatisch Android-Berechtigungen im Manifest Ihrer App. Der/die Nutzer/in des Geräts wird zur Laufzeit nicht zur Genehmigung der Berechtigung aufgefordert. Die Berechtigungen Ihrer App werden anhand der Liste der zulässigen Berechtigungen überprüft, und Apps, die Berechtigungen anfordern, die über die Genehmigungsliste hinausgehen, werden abgelehnt.
Berechtigung | Beschreibung |
---|---|
android.permission.ACCESS_COARSE_LOCATION android.permission.ACCESS_FINE_LOCATION | Das Terminal SDK erfordert Zugriff auf feine und grobe Standorte und diese Berechtigungen werden automatisch zum Manifest hinzugefügt, wenn eine App das SDK als Abhängigkeit hinzufügt. |
android.permission.ACCESS_NETWORK_STATE android.permission.ACCESS_WIFI_STATE | Apps können ihre Konnektivität überprüfen. |
android.permission.BLUETOOTH android.permission.BLUETOOTH_ADMIN android.permission.BLUETOOTH_ADVERTISE android.permission.BLUETOOTH_CONNECT android.permission.BLUETOOTH_SCAN | Apps können sich mit Bluetooth-Peripheriegeräten verbinden. |
android.permission.FOREGROUND_SERVICE | Apps können Dienste mit langer Laufzeit haben. |
android.permission.INTERNET | Apps können auf das Internet zugreifen. |
android.permission.READ_BASIC_PHONE_STATE | Apps können den grundlegenden Gerätestatus lesen, wie z. B. die Softwareversion. |
android.permission.READ_EXTERNAL_STORAGE android.permission.RECEIVE_BOOT_COMPLETED android.permission.WAKE_LOCK com.android.alarm.permission.SET_ALARM | Apps können auf verschiedene Funktionen zugreifen. |
Vorsicht
Die Funktionen und APIs für Kamera, Bluetooth und Standortbestimmung befinden sich noch in der Versuchsphase und wurden von Stripe noch nicht vollständig, getestet, validiert und genehmigt. Ihre Leistung, Zuverlässigkeit und Stabilität werden nicht garantiert. Nutzen Sie diese Funktionen nach Ihrem eigenen Ermessen.
Die NFC-Funktion der Geräte unterstützt nur Zahlungen. Sie kann nicht für nicht zahlungsbezogene Funktionen verwendet werden.
Kompatibilität von Apps on Devices und Stripe Connect
„Apps auf Geräten“ unterstützt alle Connect-Kontotypen. Eine einzige Plattform muss bestimmte Arten von verbundenen Konten kontrollieren.