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

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.

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:

• Verkauf von virtuellen Gegenständen gegen virtuelle Währung
• Freund beschenken
• Erweiterter Betrugsschutz
• Speicherung von Nutzerdaten
• Verkauf von Ingame-Währung an Automaten
• Prämien
• Gutscheine
• Kennzeichnungen
• Store API-Integration

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:

• Verkauf von virtuellen Gegenständen gegen virtuelle Währung
• Katalog anhand von Benutzerattributen erstellen
• Freund beschenken
• Erweiterter Betrugsschutz
• Speicherung von Nutzerdaten
• Prämien
• Gutscheine
• Kennzeichnungen
• Store API-Integration

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:

• Regionale Beschränkungen
• Verkaufsbeschränkungen für Schlüssel
• Erweiterter Betrugsschutz
• Speicherung von Nutzerdaten
• Vorbestellungen
• Prämien

Verkauf von Gegenständen

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

Verkauf über den Direktlink

Folgender Link wird zum Öffnen des Zahlungsportals verwendet:

https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}

• 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:

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:

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:

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

<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>

• 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

Basierend auf Store API

1. Abrufen der Liste der virtuellen Gegenstände, virtuellen Währungspakete und Spiele.
2. Kauf von Gegenständen:
   • Schnellkauf eines Gegenstands. Ein Token zum Aufrufen des Zahlungsportals wird an die Antwort übermittelt.
   • Kauf mehrerer Gegenstände:
     • Hinzufügen eines Gegenstands zum Warenkorb.
     • Abrufen der Liste der Gegenstände im Warenkorb.
     • Für die Gegenstände im Warenkorb zahlen. Ein Token zum Aufrufen des Zahlungsportals wird an die Antwort übermittelt.

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

Basierend auf Demo-Version

Authentifizierungseinstellungen

Nicht authentifizierte Benutzer

• 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:

{
 "name": "John Smith" 
 "email": "test@test.com" 
 "country": "US" 
}

"user": {
 "name": "John Smith" 
 "email": "test@test.com" 
 "country": "US"
}

Authentifizierte Benutzer

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.

• Registrierung (JWT oder OAuth2.0)
• Authentifizierung über eine der folgenden Optionen:
  • Benutzername und Passwort (JWT oder OAuth2.0)
  • soziale Netzwerke (JWT oder OAuth2.0)
• Passwort zurücksetzen

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:

• Benutzervalidierung
• Zahlung
• Erstattung
• Abrufen des Warenkorbinhalts beim Kauf

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.

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:

• Verkauf von virtuellen Gegenständen gegen virtuelle Währung
• Erstellen eines Katalogs gemäß Benutzerattributen
• Regionale Verkaufsbeschränkungen
• Geldspenden an Entwickler
• Beschränkungen beim Verkauf von Schlüsseln
• Freund beschenken
• Erweiterte Betrugsbekämpfung
• Speicherung von Nutzerdaten
• Verkauf von Ingame-Währungen an Automaten
• Vorbestellungen
• Prämien
• Gutscheine
• Promocodes
• Labels
• Upgrades
• Integration der Store API
• Berechtigungssystem
• Integration in PlayFab

Tutorials