Wenn Sie aufseiten von Xsolla virtuelle Gegenstände erstellen, können Sie regionale Preise und Limits konfigurieren sowie das Werbeaktionssystem und andere Xsolla-Funktionen nutzen, die regelmäßig erweitert und verbessert werden.

Gruppe erstellen

Um virtuelle Gegenstände einzurichten, müssen Sie Gruppen virtueller Gegenstände konfigurieren. Anhand von Gruppen können Sie einen mehrstufigen Katalog erstellen und die im Online-Shop angebotenen Artikel verwalten.

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Online-Shop.
3. Klicken Sie bei Virtuelle Gegenstände auf:
   • Verknüpfen, sofern Sie noch keine virtuellen Gegenstände konfiguriert haben.
   • Konfigurieren, sofern Sie zuvor bereits virtuelle Gegenstände konfiguriert haben.
4. Wählen Sie in der Drop-down-Liste die Option Gruppe erstellen.

5. Legen Sie die folgenden Parameter fest:
   • External ID – Gruppen-ID im Shop. Dient dazu, die Gruppe virtueller Gegenstände über API-Aufrufe zu verwalten. Jede Gruppe muss über eine eindeutige ID verfügen.
   • Gruppenname.
6. Stellen Sie den Schalter Gruppe im Online-Shop anzeigen auf Ein, damit die Gegenstände aus dieser Gruppe im Online-Shop angezeigt werden.
7. Klicken Sie auf Gruppe erstellen.

Virtuelle Gegenstände erstellen

1. Klicken Sie auf den Namen der erstellten Gruppe.
2. Klicken Sie auf Artikel anlegen.

3. Machen Sie Angaben zum Artikel. Pflichtfelder:
   • SKU – eindeutige Artikel-ID
   • Gegenstandsname
   • Beschreibung
   • Preise in echter Währung
4. Stellen Sie den Schalter Gegenstand im Store aktivieren auf Ein.
5. Klicken Sie auf Artikel anlegen.

Für die nächsten Schritte benötigen Sie die SKU des erstellten Artikels:

Nutzen Sie die API-Aufrufe aus der Untergruppe Admin der Gruppe Virtual Items & Currency, um virtuelle Gegenstände einzurichten.

Die Basisauthentifizierung wird für API-Aufrufe genutzt. Übermitteln Sie Authorization:Basic <your_authorization_basic_key>, wobei <your_authorization_basic_key> das gemäß dem Base64-Standard kodierte Paar Händler-ID:API-Schlüssel ist. Die Parameter finden Sie im Kundenportal:

• Die Händler-ID finden Sie:
  • unter Firmeneinstellungen > Firma.
  • in der URL in der Adresszeile des Browsers auf einer beliebigen Seite im Kundenportal. Die URL weist das folgende Format auf: https:​//publisher.xsolla.com/<merchant ID>/<Publisher Account section>.

• Der API-Schlüssel wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in den folgenden Abschnitten erstellen:
  • Firmeneinstellungen > API-Schlüssel
  • Projekteinstellungen > API-Schlüssel

Nutzen Sie die API-Aufrufe aus der Untergruppe Catalog der Gruppe Virtual Items & Currency, um den Katalog mit virtuellen Gegenständen aufseiten des Clients abzurufen. Diese Aufrufe erfordern keine Basisautorisierung.

Nutzen Sie den API-Aufruf Get virtual items list, um die komplette, nicht in Gruppen unterteilte Liste der Gegenstände abzurufen. Um eine Liste der in einer bestimmten Gruppe enthaltenen Gegenstände abzurufen, übermitteln Sie den Parameter external_id an den Aufruf Get items list by specified group.