Fehlerbehebung für Apps auf Geräten

Ihre App wird nicht auf Stripe hochgeladen

Wenn Ihre APK-Datei zu groß ist oder Ihre Upload-Internetgeschwindigkeit zu langsam ist, erhalten Sie möglicherweise einen Timeout-Fehler, wenn Sie Ihre APK-Datei mit der Files API hochladen. Stripe erzwingt auf seinen Servern eine Zeitüberschreitung von 45 Sekunden und gibt einen Fehler aus, wenn eine App nicht innerhalb dieser Zeit hochgeladen wird. Um das Problem zu beheben, laden Sie Ihre APK-Datei auf einen Server mit besserer Internetverbindung hoch (zum Beispiel eine AWS EC2-Instanz oder einen anderen VPS) und laden Sie sie dann von dort aus auf Stripe hoch. Die Netzwerkverbindung zwischen Ihrem Server und den Servern von Stripe ist in der Regel viel schneller ist als die Heim- oder Büroverbindungen zu Stripe über einen ISP.

Wiedereinreichung der in der Sandbox validierten App für den Live-Modus

Wenn Sie die Genehmigung für Ihre App im Test-Modus erhalten haben und die App im Live-Modus verwenden möchten, müssen Sie sie erneut zur Genehmigung einreichen. Der App-Überprüfungsprozess ist sowohl für die Sandbox als auch für den Live-Modus gleich. Achten Sie darauf, dass Sie für die automatische Genehmigung genau dieselbe APK hochladen.

Zugriff auf den Bildschirm für Geräte-Admin-Einstellungen über Ihre App

Standardmäßig kann der/die Nutzer/in des Geräts auf die Admin-Einstellungen zugreifen, indem er vom linken Bildschirmrand wischt und auf Einstellungen tippt. Diese Methode funktioniert nicht, wenn eine Drittanbieter-App die Standard-Start-App ist. Sie können den URI stripe://settings/ verwenden, um einen Deep-Link zu den Admin-Einstellungen herzustellen und den URI dann von Ihrer App aus mit dem folgenden Code in Ihrer Aktivität oder Ihrem Fragment zu starten:

startActivity(
  Intent(Intent.ACTION_VIEW)
    .setData(Uri.parse("stripe://settings/"))
)

Aktualisierungen der Gerätesprache in Ihrem DevKit

Die Lesegerät-App im DevKit kann die Gerätesprache derzeit nicht aktualisieren. Sie können die Gerätesprache über die Android-Einstellungs-App ändern. Verwenden Sie adb, um die Android-Einstellungs-App zu starten:

$ adb shell am start -a android.settings.SETTINGS

Android-Einstellungen auf Stripe-Geräten

Aus Sicherheits- und Zuverlässigkeitsgründen blockiert Stripe die Android-Einstellungs-App auf Stripe-Geräten in der Produktion. Aus diesem Grund können Sie sie auf Stripe-Geräten nicht starten oder per Deep Link auf Android-Einstellungen verweisen.

Ausführen mehrerer Apps auf dem Stripe Reader S700/S710

Der Stripe Reader S700/S710 unterstützt die Ausführung mehrerer Apps, aber wir bieten keinen App-Launcher. Sie müssen die Funktionalität in Ihren Apps erstellen, um zwischen Apps wechseln zu können. Wenn Sie Ihre Apps bereitstellen, können Sie die default_kiosk_application angeben. Dies ist die App, die gestartet wird, wenn das Gerät nach Updates sucht und Zahlungen abgeschossen werden. Sie können das Dashboard nicht verwenden, um mehrere Apps auf einem Gerät zu konfigurieren.

Web-App auf Ihren Stripe Geräten bereitstellen

Sie können Ihre Web-App so packen, dass sie auf Ihren Stripe-Geräten ausgeführt wird. Verwenden Sie ein Framework wie Cordova, um Ihre Web-App für die Kompatibilität mit Android zu modifizieren und ein Android-Anwendungspaket (APK) zu generieren. Sie können dann das APK in Ihrem Stripe-Dashboard hochladen.

Frameworks erkennen weder Stripe noch das Android-Terminal-SDK, daher müssen Sie eine JavaScript-Bridge zwischen Ihrer Webanwendung und dem SDK erstellen, um Befehle über JavaScript zu senden.

Alternativ können Sie die servergesteuerte Integration verwenden, um Zahlungen einzuziehen, ohne die Terminalübergabe-Clientbibliothek oder eine JavaScript-Brücke verwenden zu müssen. Dadurch kann Stripe alle Zahlungseingangsbefehle und die Kommunikation mit dem Gerät abwickeln.

Ständige Neustarts in Ihrer App

Im Falle eines Absturzes starten die Stripe Terminal-Kartenlesegeräe die Standard-App neu. Dies manifestiert sich für Produktions- und DevKit-Geräte unterschiedlich:

• Produktion – Wenn Sie Ihre App als Standard-App auf Produktionsgeräten konfigurieren, wird die App bei einem Absturz automatisch neu gestartet. Wenn die App während der Initialisierung abstürzt (zum Beispiel bei einer fehlenden oder defekten Datenbankmigration), kann das Gerät in eine Absturzschleife gelangen.

• DevKit – Wenn Sie die Stripe-Zahlungs-App als Standard-App auf DevKit-Geräten konfigurieren, wird Ihre App auf dem Gerät in die Warteschlange gestellt und dann zur primären App. Wenn die App abstürzt, wird stattdessen die Stripe-Zahlungs-App neu gestartet.

App stürzt ab, wenn Zahlungen mit einer großen Anzahl von Posten verarbeitet werden

Wenn Ihre App abstürzt, während Sie versuchen, eine Zahlung mit einer großen Anzahl von Einzelposten zu verarbeiten, liegt das Problem möglicherweise beim Arbeitsspeicher. Das Android-Betriebssystem begrenzt die pro Interprozess (IPC) gesendeten Daten auf 500 KB, wenn der Status für Ihre Aktivität gespeichert wird. Um zu verhindern, dass Ihre App abstürzt, können Sie Ihre Daten außerhalb des Arbeitsspeichers speichern, zum Beispiel in einer Datenbank.

Fehler in bereitgestellten Apps

Wenn Sie einen Fehler in einer bereits bereitgestellten App entdecken, können Sie das Problem in der App beheben, eine neue Version hochladen und dann Ihre App bereitstellen.

Wie kann ich die Logs für meine App auf Produktions-Lesegeräten anzeigen?

Stripe zeigt keine Protokolle auf Produktionslesegeräten an. Für die Beoabachtbarkeit stützen wir uns auf Sentry-Integrationen.

Eine durch Sideloading installierte Point-of-Sale-App in einem DevKit wird nach einer abgeschlossenen Zahlungstransaktion nicht gestartet

Auf Stripe-Lesegeräten, die für Apps auf Geräten konfiguriert sind, wird die bevorzugte Kiosk-App nach Abschluss einer Transaktion gestartet. Auf einem DevKit wird die bevorzugte Kiosk-App des Geräts nur festgelegt, wenn Sie das Gerät in eine Bereitstellungsgruppe aufnehmen.

Um die bevorzugte Kiosk-App auf einem DevKit-Gerät festzulegen:

1. Laden Sie Ihre App hoch und wählen Sie nur DevKit-Gerätetypen aus. So können Sie die App-Prüfung überspringen.
2. Stellen Sie die App-Version für eine Bereitstellungsgruppe bereit, die Ihr DevKit als Ziel hat.