Deine erste Transaktion

In sechs Schritten von Null zu einer funktionierenden Transaktion.

1. Fügen Sie die Terminal-API zu Ihrem Projekt hinzu

Fügen Sie die Abhängigkeit Terminal API in Ihr Android-Projekt ein und deklarieren Sie die erforderliche Berechtigung sowie die Sichtbarkeit des Pakets in Ihrer AndroidManifest.xml. Die genauen Codeausschnitte finden Sie unter „SDK-Einrichtung“.

2. Installieren Sie die Wallee SoftPOS-APK auf Ihrem Gerät

Laden Sie die Wallee SoftPOS-APK herunter und installieren Sie sie auf Ihrem Android-Gerät. Dies ist der Dienst, mit dem Ihre Integrator-App eine Verbindung herstellt.

3. Fordern Sie einen Aktivierungscode an und aktivieren Sie das Gerät

Fordern Sie bei unserem Vertriebsteam einen 6-stelligen Aktivierungscode an und geben Sie diesen anschließend in der wallee SoftPOS-App ein, um das Gerät zu aktivieren. Den vollständigen Ablauf finden Sie unter Terminalaktivierung.

4. Verbinden Sie Ihre App mit dem Terminal-Dienst

Initialisieren Sie die Terminal-API in einem Halter mit Anwendungsbereich und rufen Sie sdk.connect() auf, um eine Verbindung zum SoftPOS-Dienst auf dem Gerät herzustellen.

5. Führen Sie Ihre erste Transaktion durch

Erstellen Sie ein TransactionRequest.purchase(...), richten Sie einen Transaktionskontext ein und führen Sie es aus:

Kotlin

val context = sdk.terminal.payments.createTransaction(request)
val result = sdk.terminal.payments.executeTransaction(context.transactionId)

!Wichtig!

Um erfolgreiche Zahlungen durchzuführen, können Sie nur mit geraden Beträgen wie 6,00 testen.

6. Überprüfen Sie das Ergebnis

Überprüfen Sie den Wert TransactionOutcome (z. B. APPROVED) und notieren Sie sich den Wert transactionReferenceNumber für Ihre Unterlagen.

Das war’s – Sie befinden sich nun in der QAT-Umgebung. Entdecken Sie von hier aus die Bereiche „Rückerstattungen“, „Reservierungen“, „Erfassungen“ sowie die Domänen „Konfiguration“, „Stapelverarbeitung“ und „Identifizierung“ in der Terminal-API-Referenz.