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

Um die Logik dieser Aktionen zu implementieren, müssen Sie den Bestellstatus mithilfe der SDK-Methode OrderTracking.Instance.AddOrderForTracking tracken. Übermitteln Sie der Methode die folgenden Parameter:

• projectId – Projekt-ID aus dem Kundenportal
• orderId – Bestell-ID, erhalten beim Kauf über den Warenkorb, beim One-Click-Kauf oder beim Kauf gegen virtuelle Währung
• onSuccess – Rückruf für den Fall, dass sich der Bestellstatus in done ändert
• onError – Rückruf für den Fall, dass der Xsolla-Server einen Fehler meldet

Diese Methode kapselt mehrere Methoden zum Tracken des Bestellstatus. Der Mechanismus unterscheidet sich je nach Plattform, für die die Anwendung entwickelt wurde:

• Bei WebGL-Builds basiert das Tracken auf den postMessage-Ereignissen des Zahlungsportal-Widgets. Wenn das Bezahlstation-Widget eine Nachricht sendet, dass sich der Bestellstatus in done oder cancel geändert hat, endet das Tracking.

• Bei Builds für andere Plattformen verwendet das Tracking einfache HTTP-Anfragen (Short-polling) und WebSocket-Anfragen. Das Tracking erfolgt nach dem folgenden Algorithmus:

1. 1. Eine Websocket-Verbindung wird hergestellt.
   2. Ändert sich der Bestellstatus innerhalb von fünf Minuten nicht in done oder cancel, wird die Websocket-Verbindung getrennt. Ändert sich der Bestellstatus in done oder cancel, endet das Tracking.
   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
      • sich der Bestellstatus innerhalb von zehn Minuten nicht in done oder cancel ändert

Außerdem können Sie Folgendes implementieren:

• Abruf des Bestellstatus und Bestellinhalts mithilfe der SDK-Methode CheckOrderStatus
• Webhook-Handling aufseiten Ihres Anwendungsservers für Xsolla-Transaktionsereignisse

Nützliche Links