Verkauf von Spielschlüsseln einrichten
Buy Button ermöglicht es Ihnen, Spielschlüssel auf einer Spielwebsite gegen echte oder virtuelle Währung zu verkaufen und so Ihr Spiel zu monetarisieren.
Sie können Spielschlüssel an nicht autorisierte und autorisierte Benutzer verkaufen.
Für nicht autorisierte Benutzer
Beim Tätigen eines Kaufs gelten folgende Einschränkungen:
- Benutzer können das Berechtigungssystem nicht nutzen.
- Zahlungsmethoden und das Xsolla-Guthaben werden in der Xsolla-Bezahlstation nicht gespeichert.
Waren | Verkaufsmethode |
---|---|
Exemplar eines Spiels (Spielschlüssel). | Nutzen Sie einen Direktlink oder ein Widget. |
Mehrere Exemplare des Spiels (Spielschlüssel) oder mehrere Spiele in einem Warenkorb. | Übermitteln Sie die individuelle Benutzer-ID und die E-Mail-Adresse des Benutzers. 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. |
Ein Artikel. | Per Schnellkauf-Aufruf eines Artikels. |
Mehrere Artikel in einem Warenkorb. | Übermitteln Sie die individuelle Benutzer-ID. Die individuelle Benutzer-ID wird im Titel als Zahl oder Zeile beim Aufruf der der API-Methoden des Unterabschnitts „Katalog“ aus der Methodengruppe Spielschlüssel verwendet (Parameter: x-unauthorized-id ). Die ID wird im Frontend generiert, zum Beispiel über die Bibliothek zum Generieren der Kennung. |
Für autorisierte Benutzer
Um den Zugriff der Benutzer auf Ihre Anwendung und die Funktionen der Xsolla-Produkte verwalten zu können, müssen Sie ein Authentifizierungssystem einrichten. Hierfür können Sie Xsolla-Login nutzen oder Ihr eigenes Authentifizierungssystem implementieren.
Wenn Sie Ihr eigenes Authentifizierungssystem implementiert haben und nur das Zahlungsportal benötigen, generieren Sie einen Bezahlstation-Zugriffstoken und richten Sie Webhooks auf Ihrem Server ein.
Sie können Xsolla-Login für Ihren Ingame-Shop verwenden, wenn Sie keine eigenen Server haben oder eine bestehende Lösung nutzen möchten. Die folgenden Funktionen werden aufseiten von Xsolla bereitgestellt:
- Katalog speichern und verwalten
- Preise verwalten
- Daten über regionale Preise speichern
- Benutzer authentifizieren
- Transaktionen verarbeiten
Authentifizierung über Xsolla-Login
Xsolla-Login unterstützt das OAuth 2.0-Standardprotokoll für die Benutzerregistrierung und ‑authentifizierung. Das OAuth 2.0-Standardprotokoll hilft, die Entwicklung der clientseitigen Anwendung zu vereinfachen. Mit OAuth 2.0 können Sie den Zugriffstoken aktualisieren, ohne den Benutzer einzubeziehen.
Die Daten der autorisierten Benutzer lassen sich auf folgende Weisen speichern:
- Im Xsolla-Speicher. Siehe Erste Schritte mit Xsolla-Login zum Einrichten.
- In der PlayFab-Datenbank. Die Einrichtung ist in den Anleitungen für den PlayFab-Speicher beschrieben.
- In einem kundenseitigen Speicher. Die Einrichtung ist in den Anleitungen für den kundenseitigen Speicher beschrieben.
Authentifizierung über den Zugriffstoken der Bezahlstation
So sieht der Ablauf der Interaktion zwischen Ihrem Client und dem Xsolla-Server aus:
- Ihr Client sendet eine Authentifizierungsanfrage an Ihren Server.
- Ihr Server fordert einen Autorisierungstoken an und sendet einen Header, der die Parameter
project_id/merchant_id
undapi_key
enthält, an den Xsolla-Server. - Der Xsolla-Server antwortet mit dem Bezahlstation-Zugriffstoken.
- Ihr Server übermittelt den Bezahlstation-Zugriffstoken an Ihren Client.
- Der empfangene Bezahlstation-Zugriffstoken dient als Autorisierungstoken für die Authentifizierung in der Ingame-Online-Shop- und Buy-Button-API und wird verwendet, um eine Shopoberfläche zu gestalten.
Zugriffstoken der Bezahlstation abrufen
Implementieren Sie im Backend Ihrer Anwendung eine Methode zum Abrufen eines Bezahlstation-Zugriffstokens mithilfe einer HTTP-POST-Anfrage.
Die Xsolla-API nutzt die HTTP-Basisauthentifizierung. Die Anfragen müssen den Header Authorization: Basic <your_authorization_basic_key>
enthalten, wobei <your_authorization_basic_key>
das gemäß dem Base64-Standard kodierte Paar Händler-ID:API-Schlüssel ist. Die Parameter finden Sie im Kundenportal:
- Die Händler-ID finden Sie:
- unter Projekteinstellungen > Webhooks.
- unter Firmeneinstellungen > Firma.
- in der URL in der Adresszeile des Browsers auf einer beliebigen Seite im Kundenportal. Die URL weist das folgende Format auf:
https://publisher.xsolla.com/Händler-ID/Kundeportalabschnitt
.
- Der API-Schlüssel wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in den folgenden Abschnitten erstellen:
- Firmeneinstellungen > API-Schlüssel
- Projekteinstellungen > API-Schlüssel
Weitere Informationen über die Arbeit mit API-Schlüsseln finden Sie in der API-Referenz.
Wichtige Empfehlungen:
- Sie sind selbst dafür verantwortlich, den generierten API-Schlüssel zu speichern. Der API-Schlüssel wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird.
- Halten Sie Ihren API-Schlüssel geheim. Er gewährt den Zugang zu Ihrem persönlichen Konto und Ihren Projekten im Kundenportal.
- Der API-Schlüssel muss auf Ihrem Server gespeichert sein, niemals in Binärdateien oder im Frontend.
HTTP-Anfrage:
POST https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token
Übermitteln Sie die folgenden Parameter im Anfragerumpf, um den Token abzurufen:
Parameter | Typ | Beschreibung |
---|---|---|
settings | object | Benutzerdefinierte Projekteinstellungen (Objekt). |
settings.project_id | integer | Xsolla-ID des Spiels. Kann im Kundenportal neben dem Namen Ihres Projekts eingesehen werden. Erforderlich. |
user | object | Benutzerdaten (Objekt). |
user.id | object | Benutzer-ID in Ihrem Autorisierungssystem (Objekt). |
user.id.value | string | Benutzer-ID. Erforderlich. |
user.email | object | E-Mail-Adresse des Benutzers (Objekt). |
user.email.value | string | E-Mail-Adresse des Benutzers. Muss gemäß RFC 822-Protokoll gültig sein. Erforderlich. |
user.name | object | Benutzername (Objekt). Erforderlich. |
user.name.value | string | Anzeigename des Benutzers. |
user.steam_id | object | Benutzer-ID bei Steam (Objekt). |
user.steam_id.value | string | Benutzer-ID bei Steam. Erforderlich, sofern die Anwendung auf Steam veröffentlicht ist. |
user.playfab_id | object | Benutzer-ID bei PlayFab (Objekt). |
user.playfab_id.value | string | Benutzer-ID bei PlayFab. Erforderlich, sofern die Anwendung PlayFab-Dienste nutzt, um Gegenstände zu gewähren. |
Beispielhafte Anfragen und Antworten finden Sie in der API-Referenz.
custom_parameters
, purchase
usw.), da sie sind nicht dafür bestimmt sind, einen Autorisierungs-Token abzurufen.Bei der Arbeit mit dem Ingame-Online-Shop und dem Inventar verfällt der Bezahlstation-Zugriffstokens 1 Stunde nach dem letztmaligen Aufruf der Xsolla-API. Wenden Sie sich an Ihren Account Manager, um die Verfallszeit des Bezahlstation-Zugriffstokens zu ändern.
Implementieren Sie die Logik für den Erhalt eines neuen Bezahlstation-Zugriffstokens nach dessen Verfall. Es wird empfohlen, einen neuen Token im Hintergrund abzurufen, damit sich der Benutzer nicht erneut bei der Anwendung anmelden muss.
Es ist möglich, Spielschlüssel über einen Direktlink, die Shop-Benutzeroberfläche oder ein Widget zu verkaufen.
Verkauf über Direktlink
Der folgende Link öffnet das Zahlungsportal:
- curl
https://purchase.xsolla.com/pages/buy?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}
Der Kauf von Spielschlüsseln gegen echte Währung über einen Direktlink ist nur nach Unterzeichnung der Xsolla-Lizenzvereinbarung möglich. Navigieren Sie dazu im Kundenportal zu Finanzen > Lizenzvereinbarungen, füllen Sie das Formular aus, und warten Sie auf die Bestätigung. Die Prüfung der Vereinbarung kann bis zu drei Geschäftstage dauern.
Zahlungen können Sie in der Testumgebung testen, ergänzen Sie dazu den Link um den Parameter mode=sandbox
.
Ergänzen Sie den Link um folgende Daten:
YOUR-ITEM-TYPE
– Artikeltyp:game
– Spiel;game_key
– Spiel auf einer bestimmten Plattform.bundle
– Bundle.
YOUR-PROJECT-ID
– ID Ihres Projekts aus dem Kundeportal, siehe Projekteinstellungen > Allgemeine Einstellungen > Projekt-ID.YOUR-ITEM-SKU
– SKU des Spielschlüsselpakets. Verwenden Sie die Methode Spieleliste abrufen (normalerweise sieht diese SKU wie folgt aus:unit_name_drm_sku
), um die SKU abzurufen und ein Spiel auf einer bestimmten Plattform zu verkaufen.
- Zahlungsportal-Stil: Theme (dunkel oder hell, letzteres ist voreingestellt), Größe und sonstige Parameter. Spezifizieren Sie den Parameter
ui_settings
in der URL, und übermitteln Sie einsettings.ui
-JSON-Objekt mit einer Base64-Kodierung als Wert. Beispielhafte URL mit Benutzeroberflächeneinstellungen:
- curl
https://purchase.xsolla.com/pages/buy?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=
- Token zur Übermittlung von Benutzerdaten. Dient nur dazu, Spielschlüssel an authentifizierte Benutzer zu verkaufen. Dieser Token hängt von der Authentifizierungsmethode ab. Beispielhafte URL mit einem Token:
- curl
https://purchase.xsolla.com/pages/buy?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 zum Abschließen der Zahlungen verwenden.
- Beispiel-URL für den Test:
- curl
https://purchase.xsolla.com/pages/buy?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox
Verkauf über die Shop-Benutzeroberfläche
Sie können Spielschlüssel über die Shop-Benutzeroberfläche verkaufen. Um einen Shop zu erstellen, können Sie:
- den Website-Baukasten verwenden;
- Ihren eigenen Shop erstellen und die In-Game Store & Buy Button API integrieren.
Wenn Sie Ihren eigenen Shop implementieren, können Sie die Onlineshop-Demoversion als Grundlage nutzen und um die auf GitHub veröffentlichten Codeschnipsel ergänzen.
Um Spielschlüsselpakete zu verkaufen, müssen Sie die In-Game Store & Buy Button API integrieren:
- Mit der Methode Spieleliste abrufen können Sie einen Katalog anzeigen.
- Implementieren Sie den Kauf von Spielschlüsseln:
- Verwenden Sie beim Schnellkauf eines Schlüssels die Methode Bestellung mit dem angegebenen Artikel erstellen. Diese Methode antwortet mit einem Token, der zum Öffnen des Zahlungsportals verwendet werden muss.
- Um mehrere Spielschlüssel zu kaufen, verwenden Sie die Warenkorbverwaltungsmethoden:
- Warenkorbartikel aus aktuellem Warenkorb aktualisieren, um einen Spielschlüssel in den Warenkorb zu legen.
- Warenkorb des aktuellen Benutzers abrufen, um eine Liste der im Warenkorb vorhandenen Spielschlüssel abzurufen.
- Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen, um die Spielschlüssel im Warenkorb zu bezahlen. Die Methode antwortet mit einem Token, der zum Öffnen des Zahlungsportals verwendet werden muss.
Wählen Sie eine geeignete Authentifizierungsoption, damit die Methoden korrekt funktionieren.
items.unit_items.sku
aus der Anfrage an die Methode Spieleliste abrufen übermitteln.Verkauf über Widget
Es gibt mehrere Möglichkeiten, wie Schaltflächen entwickelt und in der Xsolla-API integriert werden können:
- im Kundenportal über die Schaltflächenanpassung
- mithilfe des Zahlungsstations-Widgets
Individualisieren von Schaltflächen
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie auf Shop in der Seitenleiste.
- Bei Spieleschlüssel klicken Sie Konfigurieren.
- Wählen Sie einen Spielschlüssel und gehen Sie zur Registerkarte Widget-Anpassung.
- Im Block Anpassen wählen Sie hell als Hintergrundfarbe.
theme
im Code ändern, damit der Parameter background
einen leeren String als Wert hat.- Wenn Sie den Widget Code zu Ihrer Seite hinzufügen, enthält er vererbte Stile. Fügen Sie die Stile unten ein, um diese Stile überschreiben zu können.
style
unter dem script
zu, den Sie auf der Registerkarte Widget-Anpassung aus Gründen der CSS-Vererbung/Priorität erhalten haben.- css
/* This should be used for button positioning but note this technically repositions the entire widget */
#xsolla-buy-button-widget {
/* place code for button positioning here */
}
/* Styles the button itself */
.x-buy-button-widget.x-buy-button-widget__tiny
.x-buy-button-widget-payment-button {
background-color: #ff005b;
color: black;
}
/* Button on hover */
.x-buy-button-widget.x-buy-button-widget__tiny
.x-buy-button-widget-payment-button:hover {
background-color: #ff005b;
}
/* The following are style overrides to leave you with just the button */
/* space immediately surrounding button */
.x-buy-button-widget-button-block.x-buy-button-widget-button-block__light {
background-color: white;
}
/* space above button (including game title area) */
.x-buy-button-widget.x-buy-button-widget__tiny
.x-buy-button-widget-game-logo {
height: 200px;
background-image: none !important;
background-color: white;
}
/* Game title (located right above button) */
.x-buy-button-widget-game-name.x-buy-button-widget-game-name__light {
display: none !important;
}
- Die obengenannten Namen und der Codeschnipsel werden in Verbindung mit dem kopierten Widget-Code (das Bild bei Schritt 5) verwendet. Deswegen ist es wichtig, dass die den kopierten Widget-Code implementieren.
- Sie können den oben genannten Code so verwenden, wie er ist, oder ihn auf Ihr Szenario anpassen. Die Code-Kommentare (Zeilen 1, 3, 5, 11, 16, 18, 22, 29) sind dazu da, um festzulegen, worauf die einzelnen CSS-Regeln ausgerichtet sind, und helfen bei der künftigen Gestaltung. Wenn Sie z. B. nur die Schaltfläche (und nicht das gesamte Widget) haben möchten, müssen Sie die Hintergrundfarbe Ihrer Seite an den folgenden Stellen ersetzen, wo die Farbe ist
white
— Zeilen 20 und 27.
So erstellen Sie mehrere Schaltflächen oder SKUs.
Sie können unter Xsolla Pay2Play-Widget - einfache Integration von 4 Schaltflächen ein Code-Muster für die Erstellung mithilfe des Pay2Play Widgets finden.
Die Struktur ist ähnlich wie beim Code für das Kaufschaltflächen-Widget. Hier ein Beispiel für eine Migration:
- js
<div id="xsolla-buy-button-widget"></div>
<div id="xsolla-buy-button-widget-2"></div>
<script>
var options = {
project_id: "191204",
sku: "789",
item_type: "unit",
api_settings: {
sandbox: false,
},
widget_ui: {
target_element: "#xsolla-buy-button-widget",
theme: {
foreground: "gold",
background: "",
},
},
payment_widget_ui: {
lightbox: {
height: "700px",
spinner: "round",
},
},
};
// options for second buy button - note the different SKU and target_element
var options2 = {
project_id: "191204",
sku: "123",
item_type: "unit",
api_settings: {
sandbox: false,
},
widget_ui: {
target_element: "#xsolla-buy-button-widget-2",
theme: {
foreground: "gold",
background: "",
},
},
payment_widget_ui: {
lightbox: {
height: "700px",
spinner: "round",
},
},
};
var s = document.createElement("script");
s.type = "text/javascript";
s.async = true;
s.src = "https://cdn.xsolla.net/embed/buy-button/3.1.4/widget.min.js";
// one event listener per widget instance. repeat for more buttons, passing in different SKUs
s.addEventListener(
"load",
function (e) {
var widgetInstance = XBuyButtonWidget.create(options);
},
false
);
s.addEventListener(
"load",
function (e) {
var widgetInstance2 = XBuyButtonWidget.create(options2);
},
false
);
var head = document.getElementsByTagName("head")[0];
head.appendChild(s);
</script>
- Zeilen 1 und 2 - ein
div
pro Schaltfläche, jede mit einer eindeutigen ID. - Beginnend mit Zeile 26 sind die Optionen für die zweite Schaltfläche (festgelegt im
options2
-Objekt) zu finden. Sie benötigen einen Satz vonoptions
, wie diejenigen im obigen Beispiel für jede Kauf-Schaltfläche. Achten Sie auf die Unterschiede imsku
(Zeile 28) undtarget_element
(Zeile 34, mit Ziel aufdiv
in Zeile 2).
War dieser Artikel hilfreich?
Diese Seite bewerten
Jetzt nicht
Vielen Dank für Ihr Feedback!
Weitere Informationen
Nächste Schritte
Webhooks einrichtenHaben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.