Shop in Spiel integrieren
Nachdem Sie Waren (virtuelle Gegenstände, virtuelle Währung, Bundles, Schlüssel) im Kundenportal erstellt und konfiguriert haben, erweitern Sie Ihr Spiel um einen Ingame-Shop:
- Implementieren Sie die Anzeige des Artikelkatalogs.
- Implementieren Sie die Logik für den Verkauf von Artikeln.
Artikelkatalog anzeigen
Implementieren Sie die Anzeige des Artikelkatalogs über die In-Game Store-API-Aufrufe:
Funktion | API |
---|---|
Zeigt eine vollständige Liste der im Shop erhältlichen virtuellen Gegenstände an | Liste virtueller Gegenstände abrufen |
Zeigt eine Liste der clientseitig erhältlichen Gruppen virtueller Gegenstände an | Get item groups list |
Ruft eine Liste der clientseitig im Shop erhältlichen virtuellen Währungen ab | Liste virtueller Währungen abrufen |
Zeigt eine vollständige Liste der clientseitig im Shop erhältlichen virtuellen Währungspakete an | Liste virtueller Währungspakete abrufen |
Zeigt eine vollständige Liste der im Shop erhältlichen Bundles an | Liste der Bundles abrufen |
1
zu.Artikel verkaufen
Artikel lassen sich auf folgende Arten verkaufen:
- Schnellkauf eines Artikels. Dabei können Sie eine SKU in beliebiger Menge verkaufen (z. B. 100 identische Tränke oder eine eigens festgelegte Menge virtueller Währung).
- Warenkorb kaufen. Dabei kann der Spieler einen Warenkorb zusammenstellen, anschließend Artikel hinzufügen oder entfernen oder Mengen ändern.
Schnellkauf
- Rufen Sie den API-Aufruf Bestellung mit angegebenem Artikel anlegen auf. Daraufhin wird ein Token für das Öffnen des Zahlungsportals in der Antwort übermittelt.
- Öffnen Sie das Zahlungsportal mit dem erhaltenen Zahlungstoken.
Warenkorbkauf
Implementieren Sie die folgende Logiken:- Warenkorb zusammenstellen und Token abrufen:
- Im Client – Wenn Sie den Warenkorb selbst in Ihre Anwendung implementieren möchten.
- Auf dem Server – Wenn Sie die Lösung von Xsolla (In-Game Store-API-Aufrufe) verwenden möchten, um den Warenkorb zu verwalten.
- Zahlungsportal öffnen.
Warenkorb im Client zusammenstellen und kaufen
Implementieren Sie die Logik für das Hinzufügen und Entfernen von Artikeln selbst. Bedenken Sie außerdem, dass Sie vor dem für die Zusammenstellung eines Warenkorbs nötigen API-Aufruf keine Infos darüber haben, welche Werbeaktionen auf den Kauf angewendet werden. Das heißt die Gesamtkosten und die hinzugefügten Bonusartikel sind nicht bekannt.
- Nachdem der Spieler einen Warenkorb zusammengestellt hat, rufen Sie den API-Aufruf Artikel in den Warenkorb legen auf. Die aktuellen Informationen über die ausgewählten Artikel (Preise mit und ohne Rabatt, Bonusartikel) werden in der Antwort übermittelt.
- Rufen Sie den API-Aufruf Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen auf. Die Bestell-ID und der Zahlungstoken werden in der Antwort übermittelt. Die angelegte Bestellung erhält den Status Neu.
- Öffnen Sie das Zahlungsportal.
Warenkorb auf dem Server zusammenstellen und kaufen
Bei dieser Variante kann die Zusammenstellung des Warenkorbs länger dauern, da jede Änderung des Warenkorbs einen API-Aufruf erfordert.
Führen Sie die folgenden Schritte aus:
- Warenkorb ändern:
- Um einen Artikel hinzuzufügen oder die Artikelmenge zu ändern, rufen Sie den API-Aufruf Update cart item by card ID auf.
- Um einen Artikel zu entfernen, rufen Sie den API-Aufruf Delete cart item by card ID auf.
- Rufen Sie den API-Aufruf Create order with all items from the current cart auf. Die Bestell-ID und der Zahlungstoken werden in der Antwort übermittelt. Die angelegte Bestellung erhält den Status Neu.
- Öffnen Sie das Zahlungsportal.
Zahlungsportal öffnen
Öffnen Sie zum Bezahlen von Artikeln das Zahlungsportal. Ein Token für das Öffnen des Zahlungsportals wird in der API-Antwort Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen übermittelt.
Implementieren Sie das Öffnen des Zahlungsportals. Es stehen zwei Möglichkeiten zur Auswahl:
- In einem neuen Fenster. Nutzen Sie folgenden Link, um das Zahlungsportal in einem neuen Browser-Fenster zu öffnen:
https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN
, wobeiACCESS_TOKEN
dem Token entspricht, den Sie beim Anlegen der Bestellung erhalten haben. - Über das Widget. Nutzen Sie dafür das Xsolla-Zahlungsportal-Widget-Skript (Anweisungen in der README-Datei).
Zahlungsvorgang testen
Sie können den Zahlungsvorgang in der Testumgebung testen. Dabei können Sie eine Testbankkarte und ein beliebiges Konto verwenden.
Nachdem die erste echte Zahlung erfolgt ist, tritt eine strenge Sandbox-Zahlungsrichtlinie in Kraft. Eine Zahlung in der Testumgebung bzw. im Sandbox-Modus ist nur für Benutzer verfügbar, die unter Kundenportal > Firmeneinstellungen > Nutzer angegeben sind.
Der Kauf von virtueller Währung und virtuellen Gegenständen gegen echte Währung ist nur nach Unterzeichnung der Xsolla-Lizenzvereinbarung möglich. Navigieren Sie dazu im Kundenportal zu Vereinbarungen und Steuern > Vereinbarungen, füllen Sie das Formular aus, und warten Sie auf die Bestätigung. Die Prüfung der Vereinbarung kann bis zu drei Geschäftstage dauern.
sandbox
in der Schnellkauf- und Warenkorb kaufen-Anfrage ändern. Die Testumgebung ist standardmäßig deaktiviert.Benutzerbestellstatus abrufen
Sie können Benutzerbestellstatus auf eine der folgenden Weisen abrufen:
Benutzerbestellstatus serverseitig über Webhooks abrufen
Nachdem Sie Webhooks auf Ihrem Server konfiguriert haben, können Sie damit die Details und den Status der Bestellung abrufen.Benutzerbestellstatus clientseitig über die WebSocket API oder die IGS API abrufen
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 (
Canceled
oderDone
) 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.Letztmalig aktualisiert: 8. November 2024War dieser Artikel hilfreich?Vielen Dank für Ihr Feedback!Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.