Buy Button

Buy Button ist eine umfassende Lösung zum Verkauf digitaler Waren.

Note: Falls Sie bereits Xsolla-Produkte einsetzen und Buy Button integrieren möchten, kontaktieren Sie Ihren Account Manager.

So funktioniert's

Schritt 1

Schritt 2

Schritt 3

Ablauf für den Nutzer

Integrationsablauf

So integrieren Sie Buy Button:

  1. Registrieren Sie sich im Kundenportal von Xsolla.
  2. Erstellen Sie ein Projekt.
  3. Wählen Sie Ihre Monetarisierungsoption(en).
  4. Wählen Sie die Option für den Verkauf von Gegenständen.
  5. Konfigurieren Sie Webhooks.

Note: In diesem Leitfaden werden die minimalen Einstellungen beschrieben, die für den Schnellstart der Lösung erforderlich sind. Bei Fragen wenden Sie sich bitte an Ihren Kontoverwalter.

Projekt anlegen

  1. Gehen Sie zu Projekte und klicken Sie auf Neues Projekt anlegen.
  2. Im Setup-Modus:
    1. Legen Sie die Webhook-URL fest.
    2. Generieren Sie einen geheimen Schlüssel, um Webhooks für das Projekt signieren zu können.

Monetarisierungsmöglichkeiten

Virtuelle Währung

Unsere Option für Virtuelle Währung ermöglicht Spieleentwicklern den Verkauf von Ingame-Währung. Hauptmerkmale:

  • Verkauf von Ingame-Währungspaketen
  • Durchführung von Werbekampagnen
  • Verwaltung von Benutzer-Kontoständen und der darauf befindlichen Ingame-Währung
  • Automatische Erkennung der Benutzerwährung und des Benutzerstandorts (Land)

Einrichtung

  1. Gehen Sie zu den Einstellungen für die Virtuelle Währung und legen Sie folgende Parameter fest:
    • Name
    • Stückpreis
    • Bild
  2. Erstellen Sie beliebig viele virtuelle Währungspakete und stellen Sie die folgenden Parameter für jedes dieser Pakete ein:
    • Preis
    • Bild
  3. Schalten Sie die Pakete frei, damit sie im Online-Shop angezeigt werden.

Anleitungen

Mit unseren Anleitungen können Sie einige der erweiterten Funktionen unserer Virtuellen Währung ausprobieren:

Virtuelle Gegenstände

Die Option Virtuelle Gegenstände gestattet Ihnen, Ingame-Inhalte gegen echte oder virtuelle Währungen zu verkaufen Hauptmerkmale:

  • Festlegen von Preise in echter und virtueller Währung
  • Erstellung von Katalogen mit einer oder mehreren Ebenen
  • Zugriffsverwaltung von Inhalten. Sie können beispielsweise einen bestimmten Gegenstand ausschließlich Benutzern verfügbar machen, die einen gewissen Level erreicht haben.
  • Konfiguration kurzer und detaillierter Gegenstandskarten
  • Durchführung von Werbekampagnen
  • Verwaltung von Benutzer-Kontoständen und der darauf befindlichen Ingame-Währung
  • Automatische Erkennung der Benutzerwährung und des Benutzerstandorts (Land)

Einrichtung

  1. Gehen Sie zu den Einstellungen für virtuelle Gegenstände.
  2. Vervollständigen Sie den Katalog des Online-Shops:
    1. Legen Sie eine Gegenstandsgruppe an
    2. Erstellen Sie eine Gegenstand und legen Sie dabei Folgendes fest:
      • Eine oder mehrere Gruppen, zu denen der Gegenstand gehören soll
      • SKU
      • Name und kurze Beschreibung
      • Preise in echter und virtueller Währung
      • Bild
  3. Schalten Sie die Gruppe frei, damit sie im Online-Shop angezeigt wird.

Anleitungen

Mit unseren Anleitungen können Sie einige der erweiterten Funktionen der Option für Virtuelle Gegenstände ausprobieren:

Spielschlüssel

Die Spielschlüssel-Lösung ermöglicht es Partnern, Spielschlüssel, Builds und Distributionspakete direkt über die Spielwebsite zu verkaufen. Möglich ist das über den Direktlink, das Widget oder über die Benutzeroberfläche des Online-Shops, welcher über die API-Methoden integriert ist. Hauptmerkmale:

  • Auswahl der DRM-Plattformen, über die Schlüssel und Distributionspakete verteilt werden sollen
  • Festlegen unterschiedlicher Preise für verschiedene DRM-Plattformen
  • Vorbestellungen

Einrichtung

Modul einrichten:

  1. Gehen Sie zu Spielschlüssel-Einstellungen und klicken Sie auf Neues Paket.
  2. Konfigurieren Sie die Paketparameter:
    • SKU — eine eindeutige Kennung
    • Spieltitel
    • Kurze Zusammenfassung Ihres Spiels
  3. Wählen Sie die DRM-Plattformen.
  4. Legen Sie die Preise für die ausgewählten DRM-Plattformen fest.
  5. Laden Sie die Schlüssel für die ausgewählten DRM-Plattformen hoch.

Anleitungen

Mit unseren Anleitungen können Sie einige der erweiterten Funktionen von Spielschlüssel ausprobieren:

Verkauf von Gegenständen

Sie können Gegenstände über den Direktlink, das Widget oder die Online-Shop-Benutzeroberfläche verkaufen.

Info: Beim Konfigurieren des Direktlinks für den Verkauf von Spielschlüsseln hängt der Wert des Parameters YOUR-ITEM-TYPE von den Online-Shop-Managementmethoden Ihres Projekts ab. Wenn die Option Neue Online-Shop-Managementmethoden integrieren auf Ein gestellt ist, sollten Sie den Wert des Parameters an die neue Methode übermitteln.

Folgender Link wird zum Öffnen des Zahlungsportals verwendet:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}
Ergänzen Sie den Link um folgende Daten:
  • YOUR-ITEM-TYPE — Gegenstandstyp:
    • Spiel — digital_content (für ein Projekt mit alten Online-Shop-Managementmethoden) oder unit (für ein Projekt mit neuen Online-Shop-Managementmethoden)
    • physische Waren — physical_good
    • virtueller Gegenstand — virtual_item
    • virtuelle Währung — virtual_currency
    • virtuelles Währungspaket oder Bundle — bundle
  • YOUR-PROJECT-ID — Ihre Projekt-ID im Kundenportal (Ihr Projekt > Projekteinstellungen > Allgemeine Einstellungen > Projekt-ID)
  • YOUR-ITEM-SKU — SKU des Gegenstands

Sie können auch die folgenden zusätzlichen Parameter im Link übermitteln:

  • Zahlungsportal-Stil: Theme (Parameter dark steht für dunkel; der voreingestellte Parameter default sorgt für ein helles Theme), Größe und sonstige Parameter. Spezifizieren Sie den Parameter ui_settings in der URL und übermitteln Sie ein settings.ui-JSON-Objekt mit einer Base64-Kodierung als Wert. Beispielhafte URL mit Benutzeroberflächeneinstellungen:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=
  • Token zur Übermittlung von Benutzerdaten. Wird nur beim Verkauf von Artikeln an authentifizierte Benutzer verwendet und ist für virtuelle Gegenstände und virtuelle Währungen erforderlich. Dieser Token hängt von der [Authentifizierungsmethode](/de/doc/buy-button/#guides_buy_button_selling_items_authentication_settings) ab. Beispielhafte URL mit einem Token:
Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}
  • Der Parameter mode=sandbox für Testzahlungen. Sie können [Testbankkarten](/de/doc/pay-station/references/test-cards/) zum Abschließen der Zahlungen verwenden. Beispiel-URL für den Test:
Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox

Verkauf über das Widget

Das Widget ist ein Skript, das Sie für den Verkauf von Gegenständen in Ihre Website implementieren können. Beispiele für ein funktionierendes Widget finden Sie auf der Demo-Seite.

Info: Beim Konfigurieren des Widgets für den Verkauf von Spielschlüsseln hängt der Wert des Parameters YOUR-ITEM-TYPE von den Online-Shop-Managementmethoden Ihres Projekts ab. Wenn die Option Neue Online-Shop-Managementmethoden integrieren auf Ein gestellt ist, sollten Sie den Wert des Parameters an die neue Methode übermitteln.
Code für das Implementieren des Widgets:
Copy
Full screen
Small screen
<script>
    var options = {
        project_id: "YOUR-PROJECT-ID",
        item_type: "YOUR-ITEM-TYPE",
        sku: "YOUR-ITEM-SKU",
        user: "ACCESS_TOKEN",
        widget_ui: {
            target_element: '#widget-example-element'
        }
    };
    var s = document.createElement('script');
        s.type = "text/javascript";
        s.async = true;
        s.src = "https://cdn.xsolla.net/embed/buy-button/3.1.2/widget.min.js";
        s.addEventListener('load', function (e) {
          var widgetInstance = XBuyButtonWidget.create(options);
          }, false);
    var head = document.getElementsByTagName('head')[0];
    head.appendChild(s);
</script>
Ergänzen Sie obigen Code um folgende Daten:
  • YOUR-PROJECT-ID – Ihre Projekt-ID aus dem Kundenportal (Ihr Projekt > Projekteinstellungen > Allgemeine Einstellungen > Projekt-ID)
  • YOUR-ITEM-TYPE – Gegenstandstyp:
    • Spiel – digital_content (für ein Projekt mit alten Managementmethoden) oder unit (für ein Projekt mit neuen Managementmethoden
    • physische Waren – physical_good
    • virtueller Gegenstand – virtual_item
    • virtuelle Währung – virtual_currency
    • virtuelles Währungspaket oder Bundle – bundle
  • YOUR-ITEM-SKU – SKU des Gegenstands
  • ACCESS_TOKEN – Token für die Übermittlung von Benutzerdaten. Wird nur beim Verkauf von Artikeln an authentifizierte Benutzer verwendet und ist für virtuelle Gegenstände und virtuelle Währungen erforderlich. Dieser Token hängt von der Authentifizierungsmethode ab.

Weitere Informationen über die Widget-Konfiguration finden Sie in unserem GitHub.

Verkauf über die Online-Shop-Benutzeroberfläche

Für den Verkauf von Spielschlüsseln, virtuellen Gegenständen und virtueller Währung über die Online-Shop-Benutzeroberfläche können Sie eine separate Webanwendung oder eine Online-Shop-Benutzeroberfläche in das Spiel implementieren. Sie sollten die Store API verwenden oder Ihren eigenen Online-Shop auf der Grundlage einer Demo-Version erstellen, um die Liste der Gegenstände abrufen und damit arbeiten zu können.

Basierend auf Store API

Sie können das Front-End eines Online-Shops durch Integration der Store API-Methoden erstellen:
  1. Abrufen der Liste der virtuellen Gegenstände, virtuellen Währungspakete und Spiele.
  2. Kauf von Gegenständen:

Wählen Sie eine geeignete Authentifizierungsoption, damit die Methoden korrekt funktionieren.

Note: Um das Spiel über die Store API-Methoden verkaufen zu können, sollten Sie die Auswahl der DRMs im Front-End der Website implementieren. Übermitteln Sie den Parameterwert items.unit_items.sku aus der Anfrage Spiele abrufen als SKU.

Basierend auf Demo-Version

Sie können die API-Funktionen mithilfe einer Online-Shop-Demo-Version prüfen. Der zugehörige Code befindet sich in GitHub. Sie können ihn als Grundlage für die Erstellung Ihrer eigenen Version verwenden.

Authentifizierungseinstellungen

Sowohl autorisierte als auch nicht autorisierte Benutzer können Käufe tätigen.

Nicht authentifizierte Benutzer

Sie können Spiele und physische Waren an nicht authentifizierte Benutzer verkaufen, wenn Sie folgende Regeln beachten:
  • Nutzen Sie für den Verkauf einer Kopie des Spiels einen Direktlink oder das Widget ohne einen Token.
  • Übermitteln Sie die eindeutige ID und E-Mail-Adresse des Benutzers, um mehrere im Warenkorb liegende Kopien des Spiels verkaufen zu können.
  • Nutzen Sie für den Verkauf von physischen Artikeln ohne spezielle Parameter die Methoden für den Schnellkauf.
  • Übermitteln Sie die eindeutige Benutzer-ID, um mehrere im Warenkorb liegende Kopien verkaufen zu können.

Sie sollten beim Aufruf der Store API-Methoden die eindeutige Benutzer-ID im Titel als Zahl oder Zeile angeben (Parameter x-unauthorized-id). Die Kennung wird aufseiten des Front-End generiert, beispielsweise über die Bibliothek zum Generieren der Kennung.

Die E-Mail-Adresse und sonstige Daten (Benutzername und Landescode gemäß ISO 3166-1 alpha-2) liegen in der Base64-Kodierung vor und werden beim Aufruf der Methode für das Abrufen eines Zahlungstokens im Titel für den Parameter x-user übermittelt.

Beispiel:

Copy
Full screen
Small screen
{
 "name": "John Smith" 
 "email": "test@test.com" 
 "country": "US" 
}
Außerdem können Sie die Daten an body oder query im Objektformular übermitteln. Beispiel:
Copy
Full screen
Small screen
"user": {
 "name": "John Smith" 
 "email": "test@test.com" 
 "country": "US"
}

Authentifizierte Benutzer

Für die Authentifizierung von Benutzern stehen folgende Optionen zur Verfügung:
  1. Bei integriertem Xsolla-Login wird die Anfrage über den JWT des Xsolla-Login authentifiziert.
  2. Bei Nutzung Ihres eigenen Authentifizierungssystems wird die Anfrage über den Zugriffstoken der Bezahlstation authentifiziert.

Einrichtung der Authentifizierung über Xsolla-Login

  1. Befolgen Sie die Anweisungen, um ein Projekt im Kundenportal einzurichten.
  2. Implementieren Sie den Authentifizierungsmethoden-Rückruf basierend auf dem JSON Web Token oder dem OAuth 2.0-Protokoll.
Implementieren Sie folgende Methoden, wenn die Nutzerdaten bei Xsolla gespeichert sind:

Verwenden Sie die Anleitung für den PlayFab-Speicher, wenn die Nutzerdaten in der PlayFab-Datenbank hinterlegt sind.

Verwenden Sie die Anleitung für den kundenseitigen Speicher, wenn Sie Nutzerdaten in einem benutzerdefinierten Speicher hinterlegen.

Einrichtung der Authentifizierung über Zugriffstoken der Bezahlstation

Authentifizierungsablauf:

  1. Ihr Client sendet die Authentifizierungsanfrage an Ihren Server.
  2. Ihr Server übermittelt die Merchant ID und den API key an den Xsolla-Server und fordert den access_token an.
  3. Der Xsolla-Server sendet den access_token an Ihren Server.
  4. Ihr Server sendet den access_token an Ihren Client.

Der zurückgegebene access_token dient als Authentifizierungstoken, um die vom Spiel-Client gesendeten Anfragen zu authentifizieren.

Webhooks einrichten

Implementieren Sie folgende Webhooks für die Bezahlstation:

Bestätigen Sie den Erhalt eines Webhooks, indem Sie mit dem HTTP-Statuscode 204 ohne Nachrichtenrumpf antworten. Mehr zum Thema Webhooks, einschließlich Beispielen, finden Sie in der API-Referenz.

Note: Rufen Sie nach der Webhook-Einrichtung die Bezahlstation-Einstellungen auf, und stellen sie die Option Checkout auf Ein.

Werbemöglichkeiten

Gutscheine

Gutscheine ermöglichen es Partnern, eine Werbekampagne zu erstellen, bestehend aus Gutscheincodes, die entweder vom Partner hochgeladen oder im Kundenportal generiert werden können. Gutscheine gewähren einem Benutzer virtuelle Währung, virtuelle Gegenstände oder Probetage für ein Abo-Modell. Passen Sie die Anzahl der Einlösungen und ggf. das Verfallsdatum an.

Siehe Anleitung

Kennzeichnungen

Mit der Funktion Kennzeichnungen können Partner Kennzeichnungen an beworbene virtuellen Gegenständen und virtuellen Währungspaketen anbringen. Zum Beispiel: "Best Value".

Siehe Anleitung

Prämien

Mit der Funktion "Prämien" können Benutzer zusätzlich zum Kauf einen Bonusartikel erhalten. Folgende Dinge können als Prämie zum Einsatz kommen:

  • Virtuelle Währung
  • Probetage für ein Abonnement
  • Ein oder mehrere virtuelle Gegenstände
  • Spiel(e)
  • Physische Waren (z.B. Merchandise-Artikel)

Siehe Anleitung

Anleitungen

Mit unserer Anleitung können Sie einige der erweiterten Funktionen des Buy Button ausprobieren:

Tutorials