Verkauf von Artikeln einrichten

Artikel verkaufen

Artikel lassen sich auf folgende Arten verkaufen:

1. 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).
2. Warenkorb kaufen. Dabei kann der Spieler einen Warenkorb zusammenstellen, anschließend Artikel hinzufügen oder entfernen oder Mengen ändern.

Schnellkauf

Warenkorbkauf

1. 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.
2. 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.

1. 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.
2. 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.
3. Ö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:

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

2. 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.
3. Ö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, wobei ACCESS_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).