Verkauf über Direktlink

Hinweis

Bevor Sie den Verkauf per Direktlink einrichten, müssen Sie in Ihrem Konto Spielschlüsselpakete erstellen.

Zusätzlich können Sie in Ihrem Projekt Folgendes einrichten:

Über einen Direkt-Link können Sie Spielschlüssel überall dort verkaufen, wo sich eine Webseite oder ein In-App-Browser öffnen lässt, beispielsweise auf der Spiel-Website, in sozialen Medien, in einem Launcher, in Newslettern oder in Blogbeiträgen.

Der Link öffnet die Xsolla-Bestellseite. Auf dieser Seite durchläuft der Nutzer den gesamten Kaufvorgang: Er gibt die Bestellung auf und bezahlt sie. Sie müssen hierfür keine eigene Benutzeroberfläche entwickeln.

Dieses Format eignet sich in folgenden Fällen:

  • Sie möchten Spiele schnell über verschiedene Kanäle verkaufen oder Vorbestellungen anbieten. Platzieren Sie dazu einfach den Link auf Ihrer Website, in sozialen Medien oder in einem Newsletter.
  • Sie möchten die Anzahl der Supportanfragen aufgrund falscher E-Mail-Adressen oder inkompatibler Plattformen reduzieren. Fehlende Angaben ergänzt der Nutzer auf der Bestellseite. Wenn Sie Schlüssel für mehrere Plattformen verkaufen, können Sie die Plattform bereits in der SKU festlegen (siehe Link-Format und Parameter).

Ablauf für den Nutzer

  1. Der Nutzer ruft den Link auf.
  2. Xsolla zeigt die Bestellseite an.
  3. Der Nutzer ergänzt die Angaben, die nicht im Link enthalten waren:
    1. Er wählt eine Plattform aus, für die Spielschlüssel verfügbar sind.
    2. Er gibt einen Promocode ein (optional).
    3. Er gibt die E-Mail-Adresse ein, an die der Kaufbeleg, der Spielschlüssel und die Aktivierungsanleitung gesendet werden sollen, und klickt auf Weiter.
  1. Auf der Seite wird die eingegebene E-Mail-Adresse erneut angezeigt. Der Nutzer bestätigt die E-Mail-Adresse oder wählt Ändern aus und korrigiert sie.
Hinweis

Die einzelnen Schritte bei der Bestellung können abweichen:

  • Die Plattformauswahl ist verfügbar, wenn die SKU des Spielschlüsselpakets ohne Plattform übermittelt wird.
  • Die Eingabe eines Promocodes ist nur möglich, wenn es einen aktiven Promocode für das Spielschlüsselpaket oder das Bundle gibt.
  • Bei authentifizierten Nutzern wird die E-Mail-Adresse im Bestellformular automatisch anhand der Benutzerdaten eingetragen.
  1. Xsolla reserviert einen Schlüssel für die ausgewählte Plattform und öffnet das Zahlungsportal.
  2. Der Nutzer bezahlt die Bestellung.
  3. Nach erfolgreicher Zahlung sendet Xsolla eine E-Mail mit Kaufbeleg, Spielschlüssel und Aktivierungsanleitung an die bestätigte E-Mail-Adresse.

Ein Link für den Verkauf von Spielschlüsseln hat folgendes Format:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}

Liste der Abfrageparameter:

ParameterBeschreibung
type

Artikeltyp. Erforderlich.

Mögliche Werte:

project_id

Projekt-ID. Sie finden die ID an folgenden Stellen:

  • Neben dem Projektnamen, wenn Sie im Header des Kundenportals auf den Projektnamen klicken.
  • In der URL einer beliebigen Seite im Kundenportal. Die URL hat folgendes Format: https://publisher.xsolla.com/<merchant_id>/projects/<project_id>/.

Erforderlich.

sku

SKU des Spielschlüsselpakets. Erforderlich.

Beispiele:

  • game456 – SKU ohne Bindung an spezifische Plattform.
  • game456_steam – SKU mit Bindung an spezifische Plattform. Eine Liste der von Xsolla unterstützten Plattformen und Beispielsuffixe finden Sie in der Tabelle unten.

Um sicherzustellen, dass der Link korrekt funktioniert, können Sie den SKU-Wert mit dem API-Aufruf Spieleliste abrufen prüfen. Die Artikel-SKU wird im Parameter items.unit_items.sku zurückgegeben (in der Regel sieht die SKU wie folgt aus: game_key_sku_drm_sku).

xsolla_login_tokenDer von Xsolla Login erhaltene Benutzerauthentifizierungstoken (JWT). Details finden Sie unter Verkauf an authentifizierte Nutzer.
access_dataBase64-codiertes JSON-Objekt mit Nutzerdaten und Zahlungseinstellungen. Details finden Sie unter Verkauf an authentifizierte Nutzer.
authDer von Pay Station erhaltene Benutzerauthentifizierungstoken (JWT). Details finden Sie unter Verkauf an authentifizierte Nutzer.
ui_settingsBase64-codiertes JSON-Objekt mit Einstellungen für das Benutzeroberflächen-Theme. Details finden Sie unter Benutzeroberfläche anpassen.
modeÜbermitteln Sie den Wert sandbox, um Testzahlungen durchzuführen. Details finden Sie unter Bezahlvorgang testen.
ParameterBeschreibung
type

Artikeltyp. Erforderlich.

Mögliche Werte:

project_id

Projekt-ID. Sie finden die ID an folgenden Stellen:

  • Neben dem Projektnamen, wenn Sie im Header des Kontos auf den Projektnamen klicken.
  • In der URL einer beliebigen Seite im Konto. Die URL hat folgendes Format: https://xsolla.com/for/<business-account-type>/account/<merchant_id>/projects/<project_id>/.

Erforderlich.

sku

SKU des Spielschlüsselpakets. Erforderlich.

Beispiele:

  • game456 – SKU ohne Bindung an spezifische Plattform.
  • game456_steam – SKU mit Bindung an spezifische Plattform. Eine Liste der von Xsolla unterstützten Plattformen und Beispielsuffixe finden Sie in der Tabelle unten.

Um sicherzustellen, dass der Link korrekt funktioniert, können Sie den SKU-Wert mit dem API-Aufruf Spieleliste abrufen prüfen. Die Artikel-SKU wird im Parameter items.unit_items.sku zurückgegeben (in der Regel sieht die SKU wie folgt aus: game_key_sku_drm_sku).

xsolla_login_tokenDer von Xsolla Login erhaltene Benutzerauthentifizierungstoken (JWT). Details finden Sie unter Verkauf an authentifizierte Nutzer.
access_dataBase64-codiertes JSON-Objekt mit Nutzerdaten und Zahlungseinstellungen. Details finden Sie unter Verkauf an authentifizierte Nutzer.
authDer von Pay Station erhaltene Benutzerauthentifizierungstoken (JWT). Details finden Sie unter Verkauf an authentifizierte Nutzer.
ui_settingsBase64-codiertes JSON-Objekt mit Einstellungen für das Benutzeroberflächen-Theme. Details finden Sie unter Benutzeroberfläche anpassen.
modeÜbermitteln Sie den Wert sandbox, um Testzahlungen durchzuführen. Details finden Sie unter Bezahlvorgang testen.

Um Spielschlüsselpakete für eine bestimmte Plattform zu verkaufen, müssen Sie im Abfrageparameter sku die SKU des Spielschlüsselpakets mit einem Plattform-Suffix versehen. Je nachdem, wo Sie das Paket erstellen, wird das Suffix automatisch hinzugefügt oder muss manuell ergänzt werden.

  • Wenn Sie Spielschlüsselpakete in Ihrem Konto erstellen, wird das Suffix der jeweiligen Plattform (z. B. _steam oder _playstation) automatisch an die von Ihnen manuell eingegebene SKU angehängt, getrennt durch einen Unterstrich.
  • Wenn Sie plattformspezifische Spielschlüsselpakete über API-Aufrufe erstellen, können Sie das Plattform-Suffix frei vergeben, wobei nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche verwendet werden dürfen.

Liste der unterstützten Xsolla-Plattformen und Beispielsuffixe:

NameBeispiel für SKU-Suffix
Steam_steam
PlayStation_playstation
Xbox_xbox
Uplay_uplay
Origin_origin
DRM-free_drmfree
GOG_gog
Epic Games_epicgames
Nintendo Switch eShop_nintendo_eshop
Discord Game Store_discord_game_store
Oculus_oculus
Viveport_viveport
Google Stadia_stadia
MY.GAMES Store_my_game

Hinweis
Wenn Sie im Link die SKU eines für eine bestimmte Plattform bestimmtes Spielschlüsselpakets übermitteln, kann der Nutzer die Plattform auf der Bestellseite nicht ändern.

Beispiel-URL für den Verkauf eines Spiels auf Steam:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam

Benutzeroberfläche anpassen

Damit die Benutzeroberfläche der Bestellseite zum Stil Ihres Spiels passt, können Sie Theme, Größe und weitere Parameter gemäß der Anleitung anpassen. Fügen Sie dem Link den Parameter ui_settings hinzu, und übermitteln Sie darin das JSON-Objekt settings.ui in Base64-codierter Form.

Beispiel-URL zum Öffnen der Bestellseite mit benutzerdefiniertem Theme:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

Verkauf an authentifizierte Nutzer

Hinweis

Für den Verkauf von Spielschlüsseln per Direkt-Link ist keine Authentifizierung erforderlich. Der Schlüssel wird an die E-Mail-Adresse gesendet, die der Nutzer beim Kauf angibt. Eine Nutzerauthentifizierung ist erforderlich, wenn Sie die Anzahl der Schlüssel pro Nutzer begrenzen, das Berechtigungssystem verwenden oder Nutzerdaten im Xsolla-Zahlungsportal speichern möchten.

Ein zusätzlicher Authentifizierungsschritt kann die Kaufkonversion verringern.

Um Spielschlüssel an authentifizierte Nutzer zu verkaufen, fügen Sie dem Link einen der folgenden Parameter hinzu:

  • xsolla_login_token – ein über Xsolla Login erhaltener JWT. Verwenden Sie diesen Parameter, wenn Sie Nutzer über Xsolla Login authentifizieren. Um den Token abzurufen, authentifizieren Sie den Nutzer über die Login-API, z. B. mit dem Aufruf Auth by username and password.
  • auth – ein über Pay Station erhaltener Token. Verwenden Sie diesen Parameter, wenn Sie ein eigenes Authentifizierungssystem haben. Um den Token abzurufen, senden Sie von Ihrem Server die Anfrage Token erstellen. Details finden Sie unter Token zum Öffnen des Zahlungsportals abrufen.
  • access_data – ein Base64-codiertes JSON-Objekt mit Nutzerdaten und Zahlungseinstellungen. Verwenden Sie diesen Parameter, wenn Sie ein eigenes Authentifizierungssystem haben oder die E-Mail-Adresse und das Land übermitteln müssen. Die Objektstruktur entspricht dem Anfragerumpf des Aufrufs Token erstellen (die Objekte user und settings).

Beispiel eines JSON für access_data vor der Codierung:

Copy
Full screen
Small screen
 1{
 2  "user": {
 3    "id": {
 4      "value": "USER_ID"
 5    },
 6    "email": {
 7      "value": "[email protected]"
 8    },
 9    "country": {
10      "value": "US"
11    }
12  },
13  "settings": {
14    "language": "en",
15    "currency": "USD"
16  }
17}

Codieren Sie das JSON-Objekt in Base64, und übermitteln Sie das Ergebnis im Parameter access_data des Links.

Ausführliche Informationen zu Authentifizierungsmethoden und zur Generierung von Authentifizierungstoken finden Sie unter Authentifizierung für den Verkauf von Spielschlüsseln einrichten.

Beispiel-URL zum Öffnen der Bestellseite mit einem Authentifizierungstoken:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

Bezahlvorgang testen

Um den Bezahlvorgang in der Testumgebung zu testen, fügen Sie dem Link den Parameter mode=sandbox hinzu. Sie können Testbankkarten verwenden, um Transaktionen abzuschließen.

Beispiel-URL zum Öffnen der Bestellseite in der Testumgebung:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
Achtung
Beim Kauf in der Testumgebung werden die hochgeladenen Schlüssel nicht verwendet. Das System simuliert einen erfolgreichen Kauf, ohne wirkliche Schlüssel zu liefern.
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 19. November 2026

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

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!
Ihr Feedback konnte nicht gesendet werden
Versuchen Sie es später erneut oder kontaktieren Sie uns unter [email protected].