Ihre App erstellen und testen

Befolgen Sie die nachstehenden Anweisungen für Integrationen des Typ „Apps auf Geräten“.

Lesegerät erkennen und verbinden

private fun discoverReaders() {
    Terminal.getInstance().discoverReaders(
        config = HandoffDiscoveryConfiguration(),
        discoveryListener = object : DiscoveryListener {
            override fun onUpdateDiscoveredReaders(readers: List<Reader>) {
                // In handoff discovery, the list will
                // contain a single reader. Connect to
                // the reader after it is discovered.
                readers.firstOrNull()?.let { reader ->
                    connectReader(reader)
                }
            }
        },
        callback = object : Callback {
            override fun onSuccess() {
                // Handle successfully discovering readers
            }

            override fun onFailure(e: TerminalException) {
                // Handle exception while discovering readers
            }
        }
    )
}

private fun connectReader(reader: Reader) {
    Terminal.getInstance().connectReader(
        reader,
        HandoffConnectionConfiguration(
            object : HandoffReaderListener {
                override fun onDisconnect(reason: DisconnectReason) {
                    // Optionally get notified about reader disconnects (for example, reader was rebooted)
                }

                override fun onReportReaderEvent(event: ReaderEvent) {
                    // Optionally get notified about reader events (for example, a card was inserted)
                }
            }
        ),
        object : ReaderCallback {
            override fun onSuccess(reader: Reader) {
                // Handle successfully connecting to the reader
            }

            override fun onFailure(e: TerminalException) {
                // Handle exception when connecting to the reader
            }
        }
    )
}

Einzug von Zahlungen

Nachdem Sie über den Handoff-Modus eine Verbindung zum Lesegerät hergestellt haben, können Sie mit dem Einziehen von Zahlungen beginnen.

Die Stripe Reader-App übernimmt den Zahlungseinzug und andere Zahlungsvorgänge, wie beispielsweise das Speichern von Zahlungsdetails. Beim Initiieren eines Zahlungsvorgangs wird die Stripe Reader-App zur primären App und wird im Vollbildmodus gestartet. Anschließend führt die Stripe Reader-App den Kunden/die Kundin durch den Ablauf und übergibt nach Abschluss (erfolgreich oder fehlgeschlagen) oder Stornierung durch den Kunden/die Kundin die Kontrolle an Ihre App zurück. Wenn die Kontrolle an Ihre App zurückgegeben wird, wird die Stripe Reader-App weiterhin im Hintergrund ausgeführt.

Hier finden Sie ein Beispiel für den Einzug von Zahlungen in einer App des Typs „Apps auf Geräten“.

Zahlungen offline einziehen Preview

„Apps auf Geräten“ unterstützt den Zahlungseinzug im Offline-Modus.

Sie können auf die Administratoreinstellungen des Geräts zugreifen, indem Sie den Deep-Link-URI stripe://settings/ aus Ihrer App starten.

Hier finden Sie ein Beispiel für den Aufruf des Deep-Link-URI für die Admin-Einstellungen.

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

Stripe bietet keine Lösung zur Instrumentierung auf Anwendungsebene. Um Abstürze und andere Logs Ihrer Anwendung zu verfolgen, können Sie eine Bibliothek eines Drittanbieters wie Sentry und Crashlytics verwenden.

Der von Locale.getDefault() zurückgegebene Wert wird von der Sprachauswahl des Nutzers/der Nutzerin bestimmt. Sie können die Gerätesprache in den Admin-Einstellungen ändern.

Auf Stripe Android-Geräten ist die Einstellung zum automatischen Drehen des Bildschirms standardmäßig aktiviert. Ihre App kann diese Einstellung außer Kraft setzen, indem die Nutzeroberfläche bei einer bestimmten Bildschirmausrichtung gesperrt wird.

Dies kann durch Festlegen des Attributs screenOrientation für die entsprechenden <activity>-Tags im Manifest erreicht werden.

<activity
    android:name=".MainActivity"
    android:screenOrientation="portrait">
</activity>

Alternativ kann dies programmgestützt mittels Activity::setRequestedOrientation in Ihrer Activity-Klasse festgelegt werden.

class MainActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Lock to portrait orientation
        requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_PORTRAIT

        // Or, lock to landscape orientation
        // requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
    }
}

Android-Geräte von Stripe verfügen nicht über eine System-Nutzeroberfläche, einschließlich einer Zurück-Schaltfläche oder einer Statusleiste.

Wenn Ihre App den Nutzer/innen Akkustand, Ladezustand und Verbindungsstatus mitteilen muss, finden Sie Informationen dazu in der folgenden Android API-Dokumentation:

• Akkustand und Ladezustand überwachen
• Überwachen Sie den Verbindungsstatus und die Verbindungsmessung

Wenn das Stripe-Lesegerät eine Verbindung zu einer Dockingstation herstellt oder trennt, löst das Android-Betriebssystem eine Konfigurationsänderung aus.

Standardmäßig wird die Aktivität Ihrer App bei einer Konfigurationsänderung automatisch neu erstellt.

Um die automatische Aktivitätswiederherstellung beim Herstellen oder Trennen einer Verbindung mit einer Dockingstation zu deaktivieren, fügen Sie android:configChanges="uiMode" im Eintrag <activity> in Ihrer Datei AndroidManifest.xml hinzu.

<activity
    android:name=".MyActivity"
    android:configChanges="uiMode" />

Ihre Aktivität kann über Konfigurationsänderungen informiert werden, indem Sie Activity::onConfigurationChanged implementieren. Diese Methode wird nur aufgerufen, wenn Sie Konfigurationen angegeben haben, die Sie mit dem Attribut android:configChanges in Ihrem Manifest behandeln möchten.

class MainActivity : Activity() {
    override fun onConfigurationChanged(newConfig: Configuration) {
        super.onConfigurationChanged(newConfig)
        // implement custom configuration change handling logic
    }
}