Bestellstatus-Tracking einrichten
Die Zahlung muss erfolgreich gewesen sein, bevor Sie dem Nutzer Artikel gewähren können.
Wählen Sie eine Methode für das Tracken des Bestellstatus aus:
Wählen Sie die für Ihr Projekt am besten geeignete Methode für den Zugriff auf Xsolla-Daten:
Wenn Sie keinen Server haben oder die Logik für die Kaufabwicklung clientseitig implementieren möchten, stehen folgende Möglichkeiten offen:
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:
- Damit der Xsolla-Websocket-Server und Ihr Client die Bestellstatusmeldungen erkennen können, müssen Sie eine Verbindung herstellen:
- javascript
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
- Abonnieren Sie die Ereignisse mithilfe der Funktion
client.on, um neue Meldungen über den Bestellstatus zu erhalten:
- javascript
client.on('publication', (ctx) => {
//handle the status
});
- Triggern Sie die eigentliche Verbindungsherstellung:
- javascript
client.connect()
- Nutzen Sie die history method der API, um den Bestellstatus-Änderungsverlauf zu erhalten:
- javascript
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):
- javascript
{
order_id: 59614241,
status: 'new'
}
Folgende Bestellstatus sind möglich:
New– Bestellung angelegt, aber noch nicht bezahltPaid– Bestellung bezahltDone– 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 (
CanceledoderDone) 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.
HinweisHierzu 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.
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
