Virtuelle Währung

Funktionsweise

Virtuelle Währung ist virtuelles Geld, mit dem virtueller Güter gekauft werden. Je nach Einsatzbereich beeinflusst virtuelle Währung die Spielökonomie oder die Monetarisierung der gesamten Anwendung.

Hauptmerkmale:

Verkauf beliebiger Beträge virtueller Währung oder von Währungspaketen mit festem Betrag.
Verkauf virtueller Währung und virtueller Währungspakete gegen echte oder virtuelle Währung.
Begrenzung der Anzahl der zum Kauf verfügbaren virtuellen Währungspakete.
Begrenzung des Anzeigezeitraums von virtueller Währung und virtuellen Währungspaketen im Shop.
Kostenlose virtuelle Währungspakete.

Bei Rabattkampagnen sowie bei Promocode- oder Gutscheinkampagnen müssen Sie virtuelle Währungspakete verwenden. Beliebige Beträge virtueller Währung können nur in Bonusaktionen verwendet werden.

Für den Verkauf virtueller Währungen gibt es die folgenden Optionen:

Beliebiger Betrag — ermöglicht den Verkauf von virtueller Währung in dem vom Nutzer festgelegten Betrag. Um diese Option zu verwenden, implementieren Sie clientseitig ein Eingabefeld, in das der Nutzer beim Kauf den gewünschten Betrag eingeben kann.
Pakete — ermöglicht den Verkauf virtueller Währung in vordefinierten Mengen. Der Preis eines Währungspakets wird separat festgelegt und kann vom Standardpreis für die gleiche Menge dieser Währung abweichen.

Beispiel: Ein Paket enthält 100 Goldmünzen und kostet 90 $, während der Preis für eine Goldmünze 1 $ beträgt.

Einschränkungen:

Sie können einem Paket nur eine Art von virtueller Währung hinzufügen.
Ein Preis in einer anderen virtuellen Währung kann nur über API-Aufrufe konfiguriert werden.

Ein virtuelles Währungspaket kann kostenlos angeboten werden – ohne einen Preis in echter oder virtueller Währung anzugeben. Dies kann im Kundenportal oder über API-Aufrufe konfiguriert werden. Kostenlose virtuelle Währung, die nicht Teil eines Pakets ist, kann nur über API-Aufrufe erstellt werden.

Ein virtuelles Währungspaket kann kostenlos angeboten werden – ohne einen Preis in echter oder virtueller Währung anzugeben. Dies kann über Ihr Konto oder über API-Aufrufe konfiguriert werden. Kostenlose virtuelle Währung, die nicht Teil eines Pakets ist, kann nur über API-Aufrufe erstellt werden.

Ein virtuelles Währungspaket kann kostenlos angeboten werden – ohne einen Preis in echter oder virtueller Währung festzulegen. Dies kann im Konto für Handyspiele oder über API-Aufrufe konfiguriert werden. Kostenlose virtuelle Währung, die nicht Teil eines Pakets ist, kann nur über API-Aufrufe erstellt werden.

Die Menge der virtuellen Währung in einem Paket kann nur als Ganzzahl angegeben werden.

Einrichtung

Im Kundenportal einrichten

Im Konto einrichten

Bevor Sie virtuelle Währungen oder virtuelle Währungspakete einrichten, empfiehlt es sich, Gruppen zu erstellen, um Artikel zu sortieren und ihre Anzeige im Shop zu steuern.

Öffnen Sie Ihr Projekt im Kundenportal und gehen Sie zum Abschnitt Items catalog > All items > Virtual currencies.

Öffnen Sie das Projekt in Ihrem Konto und gehen Sie zum Abschnitt Items catalog > All items > Virtual currencies.

Öffnen Sie das Projekt in Ihrem Konto und gehen Sie zum Abschnitt Items catalog > All items > Virtual currencies.

Öffnen Sie das Projekt in Ihrem Konto und gehen Sie zum Abschnitt Items catalog > All items > Virtual currencies.

Öffnen Sie Ihr Projekt im Handyspiele-Konto und gehen Sie zum Abschnitt Catalog.

Wählen Sie Create manually und wählen Sie in der Drop-down-Liste Virtual currency aus.

Geben Sie im Abschnitt General settings Folgendes an:
1. SKU
2. eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
3. Name
4. Kurzbeschreibung
5. Erweiterte Beschreibung – aktivieren Sie zum Hinzufügen den entsprechenden Schalter (optional)

Laden Sie im Abschnitt Media optional ein oder mehrere Bilder oder Videos hoch – von Ihrem Gerät oder über einen Link. Im mit dem Xsolla Site Editor erstellten Shop zeigen alle Artikelkarten die Datei mit der Markierung Main an, während die übrigen Dateien nur in Artikelkarten mit Mediengalerie verfügbar sind. Die als Main markierte Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.

Legen Sie im Abschnitt Price settings Preise fest oder erstellen Sie einen kostenlosen Artikel:
- Um einen Preis festzulegen, wählen Sie Paid item, aktivieren Sie den Schalter Pricing in real currency und geben Sie den Preis an. Bei Bedarf regionale Preise konfigurieren.
- Um einen kostenlosen Artikel zu erstellen, wählen Sie Free item.

Um die Anzahl der zum Kauf verfügbaren Artikel zu begrenzen:
1. Aktivieren Sie den Schalter im Abschnitt Limits und geben Sie die Menge an.
2. Konfigurieren Sie die Häufigkeit für das Zurücksetzen des Limits. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste:
  - Daily.
  - Weekly.
  - Monthly.
  - Custom interval. Das Intervall wird ab dem Startdatum der Artikelanzeige im Shop berechnet.
  - No regular refresh.
3. Richten Sie den Zeitplan für das Zurücksetzen ein, indem Sie die zum gewählten Zeitraum passenden Parameter angeben.

Standardmäßig wird der Artikel im Katalog ausgeblendet, sobald das Kauflimit erreicht ist. Wenn das automatische Zurücksetzen des Limits konfiguriert ist, sorgt das Kontrollkästchen Show item even after users reach the purchase limit dafür, dass der Artikel bis zum nächsten Reset-Zyklus sichtbar bleibt.

So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):
1. Aktivieren Sie den Schalter im Abschnitt Add specific display period.
2. Geben Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums an.
Um das Ende des Anzeigezeitraums offen zu lassen, aktivieren Sie den Schalter No end date.

Um dem Artikel im Katalog einen weiteren Anzeigezeitraum hinzuzufügen, wählen Sie + aus. Wenn ein Artikel mehrere Anzeigezeiträume hat, muss jeder davon ein Enddatum haben. Der Anzeigezeitraum endet mit der letzten Sekunde der angegebenen Minute. Wenn beispielsweise 12:00 als Endzeit festgelegt ist, läuft der Zeitraum bis 12:00:59.

Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
1. Fügen Sie Attribute und ihre Werte im JSON-Format hinzu.
2. Erstellen Sie Attribute und ihre Werte manuell und verknüpfen Sie sie mit Artikeln.

Wenn der kostenpflichtige Artikel in Mechaniken mit zufälliger Belohnung (z. B. Lootboxen oder Gacha) verwendet wird, aktivieren Sie den Schalter Mark as paid randomized reward.

Dieser Parameter kann für Spiele erforderlich sein, die in Ländern mit gesetzlichen Beschränkungen für solche Mechaniken vertrieben werden.

Wählen Sie Create aus.
Wählen Sie im sich öffnenden Fenster den Artikelstatus aus und wählen Sie Continue aus.

Der erstellte Artikel erscheint im Abschnitt All items.

Öffnen Sie Ihr Projekt im Kundenportal und gehen Sie zum Abschnitt Items catalog > All items > Virtual currency packages.

Öffnen Sie das Projekt in Ihrem Konto und gehen Sie zum Abschnitt Items catalog > All items > Virtual currency packages.

Öffnen Sie das Projekt in Ihrem Konto und gehen Sie zum Abschnitt Items catalog > All items > Virtual currency packages.

Öffnen Sie das Projekt in Ihrem Konto und gehen Sie zum Abschnitt Items catalog > All items > Virtual currency packages.

Öffnen Sie Ihr Projekt im Konto für Handyspiele und wechseln Sie zum Abschnitt [Catalog].

Wählen Sie Create manually und wählen Sie in der Drop-down-Liste Virtual currency aus.

Geben Sie im Abschnitt General settings Folgendes an:
1. SKU
2. eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
3. Name
4. Kurzbeschreibung
5. Erweiterte Beschreibung – aktivieren Sie zum Hinzufügen den entsprechenden Schalter (optional)

Laden Sie im Abschnitt Media optional ein oder mehrere Bilder oder Videos hoch – von Ihrem Gerät oder über einen Link. Im mit dem Xsolla Site Editor erstellten Shop zeigen alle Artikelkarten die Datei mit der Markierung Main an, während die übrigen Dateien nur in Artikelkarten mit Mediengalerie verfügbar sind. Die als Main markierte Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.

Geben Sie die im Paket enthaltene virtuelle Währung und deren Betrag an.
Legen Sie im Abschnitt Price settings Preise fest oder erstellen Sie einen kostenlosen Artikel:
- Um einen Preis festzulegen, wählen Sie Paid item, aktivieren Sie die Schalter Pricing in real currency und/oder Pricing in virtual currency, und geben Sie den Preis an. Bei Bedarf regionale Preise konfigurieren.
- Um einen kostenlosen Artikel zu erstellen, wählen Sie Free item.

Ein Artikel kann Preise in mehreren echten und virtuellen Währungen haben. In diesem Fall müssen Sie für jeden Währungstyp eine Standardwährung angeben – jeweils eine unter den echten Währungen und eine unter den virtuellen Währungen.

Sie können einen Preis in virtueller Währung nur angeben, wenn die virtuelle Währung bereits im Projekt erstellt wurde.

Um die Anzahl der zum Kauf verfügbaren Artikel zu begrenzen:
1. Aktivieren Sie den Schalter im Abschnitt Limits und geben Sie die Menge an.
2. Konfigurieren Sie die Häufigkeit für das Zurücksetzen des Limits. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste:
  - Daily.
  - Weekly.
  - Monthly.
  - Custom interval. Das Intervall wird ab dem Startdatum der Artikelanzeige im Shop berechnet.
  - No regular refresh.
3. Richten Sie den Zeitplan für das Zurücksetzen ein, indem Sie die zum gewählten Zeitraum passenden Parameter angeben.

So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):
1. Aktivieren Sie den Schalter im Abschnitt Add specific display period.
2. Geben Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums an.
Um das Ende des Anzeigezeitraums offen zu lassen, aktivieren Sie den Schalter No end date.

Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
1. Fügen Sie Attribute und ihre Werte im JSON-Format hinzu.
2. Erstellen Sie Attribute und ihre Werte manuell und verknüpfen Sie sie mit Artikeln.

Wenn der kostenpflichtige Artikel in Mechaniken mit zufälliger Belohnung verwendet wird (z. B. Lootboxen oder Gacha), aktivieren Sie den Schalter Mark as paid randomized reward.

Dieser Parameter kann für Spiele erforderlich sein, die in Ländern mit gesetzlichen Beschränkungen für solche Mechaniken vertrieben werden.

Klicken Sie auf Create.
Wählen Sie im sich öffnenden Fenster den Artikelstatus aus und klicken Sie auf Continue.

Der erstellte Artikel erscheint im Abschnitt All items.

Über die API einrichten

Zum Einrichten virtueller Währungen können Sie die Aufrufe aus dem Unterabschnitt Admin in der Gruppe Virtual items and currency verwenden.

Aufrufe aus dem Unterabschnitt Admin sind nicht dazu bestimmt, einen Shopkatalog im Front-End zu erstellen. Sie sollten nicht für Landing-Pages, Webshops und In-Game-Logiken verwendet werden.

Aufgabe	API-Aufruf
Virtuelle Währung erstellen.	Create virtual currency.
Virtuelle Währung abrufen.	Get virtual currency.
Liste virtueller Währungen abrufen.	Get list of virtual currencies.
Virtuelle Währung aktualisieren.	Update virtual currency.
Virtuelle Währung löschen.	Delete virtual currency.
Menge der zum Kauf verfügbaren virtuellen Währung begrenzen.	Übergeben Sie in den API-Aufrufen Create virtual currency oder Update virtual currency folgende Parameter: `limits` – gibt die maximale Menge der zum Kauf verfügbaren virtuellen Währung an. `limits.recurrent_schedule` – definiert, wie oft das Limit zurückgesetzt wird.
Virtuelles Währungspaket erstellen.	Create virtual currency package.
Virtuelles Währungspaket abrufen.	Get virtual currency package.
Liste virtueller Währungspakete abrufen.	Get list of virtual currency packages.
Virtuelles Währungspaket aktualisieren.	Update virtual currency package.
Virtuelles Währungspaket löschen.	Delete virtual currency package.
Anzahl der zum Kauf verfügbaren virtuellen Währungspakete begrenzen.	Übergeben Sie in den API-Aufrufen Create virtual currency package oder Update virtual currency package folgende Parameter: `limits` – gibt die maximale Anzahl der zum Kauf verfügbaren virtuellen Währungspakete an. `limits.recurrent_schedule` – definiert, wie oft das Limit zurückgesetzt wird.

Weitere Informationen zu Limits finden Sie in den folgenden Anleitungen:

Der Anzeigezeitraum für virtuelle Währung im Shop kann ausschließlich über API-Aufrufe konfiguriert werden.

Virtuelle Währung im Katalog anzeigen

Die Anzeige virtueller Währung oder virtueller Währungspakete hängt davon ab, wie der Katalog implementiert ist – über den Site-Editor oder per API.

Anzeige über den Site-Editor

Im Shopkatalog können ausschließlich virtuelle Währungspakete angezeigt werden.

So zeigen Sie ein virtuelles Währungspaket an:

Virtuelles Währungspaket erstellen.
Wechseln Sie in Ihrem Projekt im Kundenportal zum Abschnitt Storefronts > Websites.
Klicken Sie auf die gewünschte Website.

Virtuelles Währungspaket erstellen.
Gehen Sie im Projekt in Ihrem Konto zum Abschnitt Storefronts > Websites.
Klicken Sie auf die gewünschte Website.

Virtuelles Währungspaket erstellen.
Gehen Sie im Projekt in Ihrem Konto zum Abschnitt Storefronts > Websites.
Klicken Sie auf die gewünschte Website.

Virtuelles Währungspaket erstellen.
Gehen Sie im Projekt in Ihrem Konto zum Abschnitt Storefronts > Websites.
Klicken Sie auf die gewünschte Website.

Virtuelles Währungspaket erstellen.
Gehen Sie in Ihrem Projekt im Konto für Handyspiele zum Bereich Web Shop.
Klicken Sie auf die gewünschte Website.

Wenn Ihre Website mehrere Seiten enthält, wählen Sie die benötigte aus:
1. Klicken Sie oben im Editor auf den aktuellen Seitentitel.
2. Wählen Sie die gewünschte Seite aus der Drop-down-Liste.
Wählen Sie im Abschnitt des Blocks Store im Feld Item type das virtuelle Währungspaket aus, das Sie auf der Website verkaufen möchten.

Artikelkarten-Layout festlegen.
Nachdem Sie alle erforderlichen Änderungen vorgenommen und Ihre Website für den Start vorbereitet haben:
1. Klicken Sie oben rechts im Site-Editor auf Publish.
2. Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen möchten.
3. Klicken Sie auf Publish.

Wenn die Veröffentlichung der Website nicht verfügbar ist, stellen Sie sicher, dass alle Bedingungen erfüllt sind:

Es gibt keine leeren Abschnitte auf der Website (gekennzeichnet durch einen roten Indikator).
Die Lizenzvereinbarung mit Xsolla wurde unterzeichnet.
Die Hauptseite ist veröffentlicht oder zur Veröffentlichung ausgewählt. Unterseiten können nicht vor der Hauptseite veröffentlicht werden.

Sobald die Website veröffentlicht ist, wird ein Abschnitt mit virtuellen Währungspaketen verfügbar. Wenn keine Pakete angezeigt werden, prüfen Sie, ob ihr Status auf Available gesetzt ist und keine zeitbasierte Anzeigebeschränkung aktiv ist.

Informationen zu virtueller Währung per API abrufen

Um den Katalog der virtuellen Währungen und virtuellen Währungspakete clientseitig abzurufen, verwenden Sie die Aufrufe aus dem Unterabschnitt Catalog der Gruppe Virtual items and currency.

Aufgabe	API-Aufruf
Virtuelle Währung per SKU abrufen.	Übergeben Sie den Parameter `virtual_currency_sku` an den API-Aufruf Get virtual currency by SKU.
Liste virtueller Währungen abrufen.	Get virtual currency list.
Virtuelles Währungspaket per SKU abrufen.	Übergeben Sie den Parameter `virtual_currency_package_sku` an den API-Aufruf Get virtual currency package by SKU.
Liste virtueller Währungspakete abrufen.	Get virtual currency package list.

Virtuelle Währung an Nutzer gewähren

Je nach Artikelart und den Integrationseinstellungen wird die virtuelle Währung dem Nutzer auf eine der folgenden Arten gewährt:

Wenn Sie PlayFab integriert haben, werden virtuelle Währungen und Gegenstände automatisch dem PlayFab-Inventar des Nutzers hinzugefügt.
Wenn Sie ein eigenes Bereitstellungssystem verwenden, werden alle virtuellen Gegenstände und Währungen auf Ihrer Seite gewährt. Wir empfehlen, einen Webhook-Handler einzurichten, um Bestelldaten in Ihrem Backend zu empfangen. Die erforderlichen Daten sind im Webhook Successful payment for order enthalten.

Ausführliche Informationen hierzu und zu weiteren Methoden zum Abrufen von Kaufdaten finden Sie im Abschnitt Bestellstatus-Tracking einrichten.

Vielen Dank für Ihr Feedback!

Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.

Letztmalig aktualisiert: 15. Mai 2026

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Inhaltsverzeichnis

Funktionsweise
Einrichtung
Im Kundenportal einrichten
Im Konto einrichten
Über die API einrichten
Virtuelle Währung im Katalog anzeigen
Anzeige über den Site-Editor
Informationen zu virtueller Währung per API abrufen
Virtuelle Währung an Nutzer gewähren