Wenn Sie keinen Server haben oder die Logik für die Kaufabwicklung clientseitig implementieren möchten, stehen folgende Möglichkeiten offen:

1. WebSocket API
2. Short-polling

Bestellstatus mithilfe der WebSocket API clientseitig abrufen

Die Lösung verwendet Websockets, um den Bestellstatus abzurufen, ohne detaillierte Informationen über die Bestellung zu erhalten. Diese Methode ist vorzuziehen, da nur eine Verbindung zwischen dem Client (z. B. Ihrer Website oder App) und dem Xsolla-Server hergestellt wird und somit die Auslastung des Clients oder des Servers nicht weiter steigt.

Gehen Sie wie folgt vor:

1. Damit der Xsolla-Websocket-Server und Ihr Client die Bestellstatusmeldungen erkennen können, müssen Sie eine Verbindung herstellen:

const client = new Centrifuge(
connectionURL,
{
data: {
  user_external_id: user_external_id,
  auth: auth,
  project_id: project_id
}
}
)
connectionURL - wss://ws-store.xsolla.com/connection/websocket
auth - user JWT token

2. Abonnieren Sie die Ereignisse mithilfe der Funktion client.on, um neue Meldungen über den Bestellstatus zu erhalten:

client.on('publication', (ctx) => {
   //handle the status
});

3. Triggern Sie die eigentliche Verbindungsherstellung:

client.connect()

4. Nutzen Sie die history method der API, um den Bestellstatus-Änderungsverlauf zu erhalten:

client.on('subscribed', function (ctx) {
   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
resp.publications.forEach((ctx) => {
   /handle the status
});

   }, function (err) {
       //handle the status
   });
});

Nachrichtenrumpf (Beispiel):

{
order_id: 59614241,
status: 'new'
}

Folgende Bestellstatus sind möglich:

• New – Bestellung angelegt, aber noch nicht bezahlt
• Paid – Bestellung bezahlt
• Done – Bestellung ausgeliefert (alle Belege gesendet, Auslieferung durch Xsolla, externe Plattformen usw. ist erfolgt)
• Canceled – Bestellung ist storniert und die Zahlung wurde dem Nutzer erstattet

Empfehlung für die Websocket-Nutzung:

• Beim Websocket-Protokoll beträgt die maximale Wartezeit auf eine Antwort fünf Minuten.
• Die Verbindung sollte beim Öffnen des Zahlungsportals hergestellt werden.
• Die Verbindung sollte getrennt werden, sobald der endgültige Bestellstatus (Canceled oder Done) empfangen wurde.
• Verwenden Sie Short-polling, wenn die Websocket-Lebensdauer abläuft oder Verbindungsprobleme auftreten.

  Short-polling

  Nutzen Sie den API-Aufruf Bestellung abrufen, um nach einer Bestellstatusänderung detaillierte Informationen über die Artikel in der Bestellung zu erhalten.

  Hinweis

  Hierzu wird eine zyklische Bestellstatusabfrage genutzt (Polling) – eine einfache HTTP-Anfrage, die den Bestellstatus und die ‑informationen abfragt. Die empfohlene Verzögerung zwischen den Anfragen beträgt 3 Sekunden.

Die Methode XsollaCatalog.Purchase kapselt mehrere Methoden zum Tracken des Bestellstatus. Der Tracking-Mechanismus ist in der Dokumentation des SDK für Unity auf Unternehmensebene ausführlich beschrieben.

Zusätzlich können Sie den Bestellstatus und den Bestellinhalt an die Kaufmethoden-Rückruffunktion onSuccess übermitteln.

Wird das SDK verwendet, können Sie den Bestellstatus auf einen der folgende Wege tracken:

• durch Abonnieren der Bestellstatusänderung
• durch Abfrage des Bestellstatus

Bestellstatusänderungen abonnieren

Ü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.

Bestellstatus abfragen

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

• 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")
            }

})

Den Bestellstatus können Sie mit der SDK-Methode CheckPendingOrder tracken. Übermitteln Sie dazu die folgenden Parameter an die Methode:

• AccessToken – den beim Kauf des Artikels erhaltenen Zahlungstoken.
• OrderId – die beim Kauf des Artikels erhaltene Bestell-ID.
• SuccessCallback – der Rückruf bei einer erfolgreichen Zahlung.
• ErrorCallback – der Rückruf bei einem Anfragefehler.
• bIsUserInvolvedToPayment – inwiefern der Nutzer am Bezahlvorgang beteiligt ist. Übermitteln Sie beim Kauf gegen echte Währung true, und beim Erhalt eines kostenlosen Artikels sowie beim Kauf gegen virtuelle Währung false.

Der Tracking-Mechanismus ist in der Dokumentation des SDK für Unreal Engine auf Unternehmensebene ausführlich beschrieben.

Rufen Sie die SDK-Methode CheckOrder auf, und übermitteln Sie die folgenden Parameter, um den Status und den Inhalt einer Bestellung abzufragen:

• AccessToken – den beim Kauf des Artikels erhaltenen Zahlungstoken.
• OrderId – die beim Kauf des Artikels erhaltene Bestell-ID.
• SuccessCallback – der Rückruf bei einer erfolgreichen Bestellüberprüfung. Die Antwort enthält den Bestellstatus.
• ErrorCallback – der Rückruf bei einem Anfragefehler.