Bestellstatus tracken

Nachdem ein Benutzer etwas gekauft hat, kann Ihre Anwendung die folgenden Aktionen durchführen:

• den Bestellstatus auf der Benutzeroberfläche anzeigen
• das Guthaben eines Benutzers nach einer erfolgreichen Zahlung belasten
• die gekauften Artikel nach erfolgreicher Zahlung gewähren

Wird die Logik dieser Aktionen mithilfe des SDK implementiert, können Sie den Bestellstatus auf einen der folgende Wege tracken:

• durch Abonnieren der Bestellstatusänderung (empfohlen)
• durch Abfrage des Bestellstatus

Bestellstatusänderungen abonnieren

Store-Bibliothekmethode verwenden

Übermitteln Sie der SDK-Methode getOrderStatus aus der Store-Bibliothek die folgenden Parameter, um Bestellstatusänderungen zu abonnieren:

• listener – Listener-Objekt vom Typ OrderStatusListener.
• orderId – Bestell-ID, die Sie beim Kauf über den Warenkorb, beim One-Click-Kauf oder beim Kauf gegen virtuelle Währung erhalten haben, als Parameter.

SDK-Referenzdokumentation

Erfahren Sie mehr über die SDK-Methoden und ihre Parameter.

Beispielhafter Aufruf der Methode XStore.getOrderStatus:

XStore.getOrderStatus(object : OrderStatusListener() {

               override fun  onStatusUpdate(status: OrderResponse.Status) {

                   if(status == OrderResponse.Status.DONE) {

                       Log.d("MainActivity", "Success")

                   }

               }

               override fun  onFailure() {

                   Log.d("MainActivity", "Failure")

               }

           }, orderId)

Wir empfehlen, die Methode XStore.getOrderStatus beim Öffnen des Zahlungsportals aufzurufen.

Die Kaufmethoden kapseln mehrere Methoden zum Tracken des Bestellstatus. Das Tracking erfolgt nach dem folgenden Algorithmus:

1. Eine Websocket-Verbindung wird hergestellt.
2. Wenn eine Websocket-Verbindung erfolgreich hergestellt wurde und sich der Bestellstatus in done oder cancel ändert, endet das Tracking. Wenn eine Websocket-Verbindung fehlschlägt oder die Antwort falsche Daten enthält, wird der Bestellstatus per Short-polling getrackt.
3. Das Tracking des Bestellstatus wird per Short-polling fortgesetzt. Alle drei Sekunden wird eine einfache HTTP-Bestellstatusanfrage gesendet. Das Tracking endet, wenn sich der Bestellstatus in done oder cancel ändert.

Payments-Bibliothekmethode verwenden

1. Übermitteln Sie beim Erstellen des Objekts XPayments.IntentBuilder den Rückruf StatusReceivedCallback mithilfe der Methode setStatusReceivedCallback.
2. Implementieren Sie die Methode onSuccess im Rückruf StatusReceivedCallback, der bei jeder individuellen Statusänderung aufgerufen wird.

Beispiel:

val intent = XPayments.createIntentBuilder(this)
               .accessToken(<accessToken>)
               .isSandbox(<isSandbox>)
           	.setStatusReceivedCallback(object : StatusReceivedCallback {
               	override fun onSuccess(data: InvoicesDataResponse) {
                   		Log.d(TAG, "StatusReceivedCallback is fired. Result data = $data")
               	}
           	})
           	.build()

Bestellstatus abfragen

1. Rufen Sie die Methode getOrder aus der Login-Bibliothek auf, und übermitteln Sie die folgenden Parameter, um den aktuellen Zahlungsstatus abzurufen:

• orderId – die Bestell-ID, die beim Kauf über den Warenkorb, beim One-Click-Kauf oder beim Kauf gegen virtuelle Währung empfangen wurde.
• callback – der Rückruf bei einem erfolgreichen Abruf der Bestellinformationen. Nutzen Sie die GetStatusCallback-Schnittstelle, und implementieren Sie die beiden Methoden onSuccess und onError, um den Rückruf zu implementieren.

Beispiel:

XPayments.getStatus(<token>, <isSandbox>, object : GetStatusCallback {
            override fun onSuccess(data: InvoicesDataResponse?) {
                Log.d(TAG, "onSuccess is fired. Result data = $data")
            }

           override fun onError(throwable: Throwable?, errorMessage: String?) {
                Log.d(TAG, "onError is fired. ErrorMessage = $errorMessage")
            }

})

Nützliche Links