Upgrades

So funktioniert's

Upgrades ermöglichen den Benutzern den Erwerb teurerer Spielpakete. Dabei muss nur für den "Wechsel" (sprich: das Upgrade) bezahlt werden. Der Preis für jedes Upgrade wird individuell festgelegt.

Note: Upgrades sind nur für Vorbestellungen oder Spiele verfügbar, deren Auslieferung über DRM-free-Distributionsdateien erfolgt. Werbeaktionen, regionale Verkaufsbeschränkungen und Freund beschenken können nicht auf Upgrades angewendet werden.

Für wen ist es

  • Partner, die die tokenlose Integration und den Online-Shop samt aktiviertem Spielschlüssel-Modul integriert haben.
  • Partner, die die Integration mit Token, den Login und den Online-Shop samt aktiviertem Spielschlüssel-Modul integriert haben.

Wie komme ich dazu

Einrichtung von Upgrades für die tokenlose Integration:

  1. Wählen Sie im Kundenportal unter Spielschlüssel Pakete aus oder erstellen Sie ein neues.
  2. Konfigurieren Sie eine Vorbestellung oder ein DRM-free Verteilungspaket. So konfigurieren Sie ein DRM-free-Verteilungspaket:
    1. Aktivieren Sie DRM-free in den Grundeinstellungen.
    2. Aktivieren Sie unter Schlüssel & Verteilungspakete die Option Verteilungspakete hochladen.
  3. Um Upgrades zu aktivieren und deren Preise festzulegen wenden Sie sich bitte an Ihren Account Manager oder senden Sie eine E-Mail an: am@xsolla.com.
  4. Konfigurieren Sie das E-Mail-Versand-Upgrade:
    1. Ergänzen Sie Ihre Website um eine Schaltfläche zum Kauf eines Upgrades und um ein Formular zur Abfrage von E-Mail-Adressen von Benutzern.
    2. Implementieren Sie die API-Methode Upgrades senden. Diese Methode ermöglicht Ihnen, den Benutzer nach seiner E-Mail zu authentifizieren und festzustellen, welche Upgrades bereits gekauft wurden.
    3. In der Anforderung übertragen Sie das access_data Objekt mit der Benutzer-E-Mail und der Artikelnummer des neuen Pakets.
    4. Nach der Auswahl eines Upgrades, erhält der Benutzer eine E-Mail samt Link zum Kauf des gewünschten Upgrades und einer Liste sonstiger verfügbarer Upgrades.

Ein Muster einer E-Mail, das der Benutzer erhalten wird:

Mehr zeigen

Upgrades für die Integration mit Token einrichten:

  1. Wählen Sie im Kundenportal unter Spielschlüssel Pakete aus oder erstellen Sie ein neues.
  2. Konfigurieren Sie eine Vorbestellung oder ein DRM-free-Verteilungspaket.
    1. Aktivieren Sie DRM-free in den Grundeinstellungen.
    2. Aktivieren Sie unter Schlüssel & Verteilungspakete die Option Verteilungspakete hochladen.
  3. Implementieren Sie folgende API Methoden: Spiele abrufen und Upgrades abrufen. Konfigurieren Sie folgende Webhooks:
    1. Zahlung und Rückerstattung. Die Upgrade-Daten werden im purchase.pin_codes.upgrade Objekt übermittelt.
    2. Upgrade zurückerstatten.
  4. Um Upgrades zu aktivieren und deren Preise festzulegen, wenden Sie sich bitte an Ihren Account Manager oder senden Sie eine E-Mail an am@xsolla.com.
  5. Um die Aufrufmethode des Zahlungsportals beim Erwerb von Upgrades zu konfigurieren, übermitteln Sie folgende Parameter im Token:
    1. user.id.
    2. purchase.pin_codes.upgrade.id_user_history, empfangen von der Spieleliste.
    3. purchase.pin_codes.upgrade.id, empfangen von der Upgrade-Liste.

Wenn ein Benutzer eine Reihe von Upgrades für ein einzelnes Paket kauft und anschließend eine Zahlung für eines der Upgrades erstattet bekommen möchte, wird dieses bestimmte Upgrade und alle nachfolgenden Upgrades storniert. Standardmäßig werden die Zahlungen für die nachfolgenden Upgrades nicht erstattet. Wenn Sie Erstattungen für die gesamte Reihe von Upgrades einrichten möchten, wenden Sie sich an Ihren Account Manager oder senden Sie eine E-Mail an am@xsolla.com.

Note: Sie können den Xsolla-Login zur Autorisierung des Benutzers verwenden, um eine user.id zu erhalten.