Ihre erste Transaktion

In sechs Schritten von Null zu einer funktionierenden Transaktion.

1. Fügen Sie die Terminal-API 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 herstellen wird.

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 anschliessend 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 Terminaldienst

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!

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

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. Erkunden Sie von hier aus die Bereiche „Rückerstattungen“, „Reservierungen“, „Erfassungen“ sowie die Domänen „Konfiguration“, „Stapelverarbeitung“ und „Identifizierung“ in der Terminal-API-Referenz.