Integration von Xsolla-Servern

Bei dieser Integrationsart werden die folgenden Aufgaben aufseiten von Xsolla durchgeführt:

  • Katalogspeicherung und ‑verwaltung
  • Preisverwaltung
  • Speicherung von Daten über regionale Preise
  • Verwaltung regionaler Beschränkungen
  • Inventarverwaltung
  • Verwaltung von Werbekampagnen
  • Benutzerauthentifizierung
  • Benutzerzugriffsverwaltung
  • Transaktionsverarbeitung

Für diese Aufgaben müssen Sie keinen eigenen Server konfigurieren.

Integrationsablauf

Integrationsteam kontaktieren
Klicken Sie unten rechts auf das Chat-Symbol und kontaktieren Sie das Integrationsteam über einen Messenger. Wir antworten Ihnen in Echtzeit und helfen, das Problem zu lösen.
Note
In diesem Leitfaden werden die minimalen Einstellungen beschrieben, die für den Schnellstart des Moduls erforderlich sind. Wenden Sie sich bei Fragen bitte an Ihren Account Manager oder senden Sie uns eine E-Mail an integration@xsolla.com.

Projekt im Kundenportal erstellen

  1. Registrieren Sie sich im Kundenportal.
  2. Konfigurieren Sie Ihr Projekt:
    1. Um die Spieldaten automatisch auszufüllen, geben Sie den Link zu Ihrem Spiel auf einer beliebigen Plattform an. Daraufhin werden das Bild des Spiels, dessen Name und dessen Beschreibung den Projekteinstellungen hinzugefügt.
    2. Um die Spieldaten manuell einzugeben, klicken Sie auf Ich habe keinen Link. Manuell einrichten, und geben Sie Folgendes an:
      • Projektsprachen (vorausgewählt: Englisch)
      • Projektname für alle angegebenen Sprachen
      • Spielwebsite (optional)
    3. Klicken Sie auf Projekt erstellen.

Während des Integrationsprozesses benötigen Sie die Projekt-ID. Diese wird im Kundenportal neben dem Projektnamen angezeigt.

Modul "Virtuelle Währung" einrichten

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie bei Online-Shop auf Verknüpfen. Wenn Sie im links im Seitenmenü auf Online-Shop klicken, gelangen Sie zu den Ingame-Shop-Einstellungen.

  1. Klicken Sie bei Virtuelle Währung auf Verknüpfen.

  1. Erstellen Sie eine virtuelle Währung:
    1. Klicken Sie auf Virtuelle Währung erstellen.

    1. Geben Sie folgende Informationen an:
      • SKU
      • Name der Währung
      • Preis für eine Einheit der virtuellen Währung
      • Standard-Währung
      • Funktionen der Premiumwährung (optional)
      • Bild (optional)
    2. Klicken Sie auf Währung erstellen.

  1. Erstellen Sie ein Paket mit virtueller Währung:
    1. Wechseln Sie zu Pakete.
    2. Klicken Sie auf Paket erstellen.

    1. Geben Sie folgende Informationen an:
      • SKU
      • Paketname
      • kurze Beschreibung
      • virtuelle Währung
      • Menge der virtuellen Währung in einem Paket
      • Preis
      • Standard-Währung
      • Bild (optional)

    1. Stellen Sie die Option Im Online-Shop anzeigen auf Ein.
    2. Klicken Sie auf Paket erstellen.

Note
Die Bibliothek unterstützt den Kauf von virtuellen Gegenständen gegen virtuelle Währung. Außerdem können Benutzer die virtuelle Währung gemäß der Ingame-Logik verwenden (Zugang zu einem Ort erhalten, im Level aufsteigen usw.). Die Benutzer geben virtuelle Währung aus, wenn sie eine Xstore.consumeItem-SDK-Methode aufrufen.

Modul "Virtuelle Gegenstände" einrichten

Note
Die SDK-Methoden unterstützen die folgenden Artikeltypen:
  • aufbrauchbarer Gegenstand – ein Gegenstand im Inventar, der wiederholt angehäuft oder gekauft werden kann und dessen Anzahl nach Gebrauch abnimmt. Der Gegenstandsbestand kann wieder aufgefüllt werden. Beispiel: Granaten und Geschosse zum Angriff auf den Gegner, Erste-Hilfe-Kästen usw.
  • Nicht aufbrauchbarer Gegenstand – ein Gegenstand im Inventar, der einmal erworben oder gekauft werden kann und nicht aus dem Inventar verschwindet. Beispiel: Zugang zu einem Standort, Status usw.
  • Zeitlich begrenzte Artikel – ein nicht aufbrauchbarer, nur für einen begrenzten Zeitraum verfügbarer Artikel. Wird auch nach dem Ablauf im Inventar angezeigt. Zum Beispiel: Premium-Zugang oder Season Pass. Weitere Einzelheiten finden Sie in der Ingame-Online-Shop-Dokumentation.

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie bei Online-Shop auf Verknüpfen. Wenn Sie im links im Seitenmenü auf Online-Shop klicken, gelangen Sie zu den Ingame-Shop-Einstellungen.

  1. Klicken Sie bei Virtuelle Gegenstände auf Verknüpfen.

  1. Klicken Sie auf Gruppe erstellen.

  1. Geben Sie den Gruppencode und den Gruppennamen an.
  2. Stellen Sie den Umschalter Gruppe im Online-Shop anzeigen auf Ein.
  3. Klicken Sie auf Gruppe erstellen.

  1. Erstellen Sie Gegenstände:
    1. Geben Sie dabei folgende Infos für jeden Gegenstand an:
      • eine oder mehrere Gruppen, zu denen der Gegenstand gehört
      • SKU
      • Name und kurze Beschreibung
      • Preise in echter und virtueller Währung
      • Bild (optional)

    1. Wählen Sie unter Einstellungen im Feld Gegenstandseigenschaften eine der folgenden Optionen aus:
      • aufbrauchbar
      • nicht aufbrauchbar
      • zeitlich begrenzte Artikel
    2. Klicken Sie auf Gegenstand anlegen.

  1. Stellen Sie sicher, dass als Status der Gruppe Aktiviert angezeigt wird.

Bezahlstation im Kundenportal einrichten

  1. Navigieren Sie zu Ihrem Projekt, und klicken Sie im Abschnitt Bezahlstation auf Öffnen. Wenn Sie zuvor kein Online-Shop-Modul installiert haben, klicken Sie unter Bezahlstation auf Verknüpfen.

  1. Öffnen Sie die Bezahlstation-Eigenschaften.
  2. Geben Sie im Abschnitt Regeln zur Weiterleitung die Rückgabe-URL und die Bedingungen für die Weiterleitung an, und klicken Sie auf Speichern.

Note
Um Benutzer zur Android-Anwendung weiterzuleiten, muss die Rückgabe-URL dem Schema app://xpayment.<ANDROID_PACKAGE_NAME> entsprechen, wobei <ANDROID_PACKAGE_NAME> der Paketname der Android-Anwendung ist.

Token abrufen

Für die ordnungsgemäße Funktion des SDK benötigen Sie einen Token. Ein Zugriffstoken ist ein String, mit dem der Zahlungsvorgang initiiert wird.

Das Abrufen eines Tokens erfolgt mithilfe der Methode Create Order with All Items from Particular Cart aus der Xsolla-Store-Bibliothek. Alternativ können Sie einen anderen Zugriffstoken nutzen, z. B. den von PlayFab erhaltenen Token.

Bibliothek installieren

Die Bibliothek ist im Maven Central verfügbar.

So installieren Sie die Bibliothek:

  1. Starten Sie Android Studio.
  2. Öffnen Sie die build.gradle-Datei Ihrer Anwendung.
  3. Fügen Sie folgende Zeile im Abhängigkeiten-Abschnitt hinzu, wobei <version_number> der erforderlichen Version der Payments-Bibliothek entspricht:

Neuste Version:

Copy
Full screen
Small screen
implementation 'com.xsolla.android:payments:<version_number>'

Zahlungsvorgang testen

Testen Sie nach erfolgreicher Konfiguration der Bibliothek den Zahlungsvorgang. Standardmäßig werden alle Zahlungen in der Testumgebung bzw. im Sandbox-Modus abgewickelt. Sie können eine Testbankkarte nutzen, um einen erfolgreichen Zahlungsvorgang zu simulieren.

So testen Sie den Zahlungsvorgang durch das Abwickeln echter Zahlungen:

  1. Stellen Sie sicher, dass Sie einen Vertrag mit Xsolla geschlossen haben.
  2. Legen Sei beim Erstellen eines Paystation-Intent-Objekts .isSandbox(false) fest.

Note
Nachdem die erste echte Zahlung erfolgt ist, tritt eine strenge Sandbox-Zahlungsrichtlinie in Kraft. Eine Zahlung in der Testumgebung bzw. im Sandbox-Modus ist nur für Benutzer verfügbar, die unter Kundenportal > Firmeneinstellungen > Nutzer angegeben sind.
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.
Diese Seite bewerten
Diese Seite bewerten
Gibt es etwas, das wir verbessern können?

Jetzt nicht

Vielen Dank für Ihr Feedback!

Weitere Informationen

Letztmalig aktualisiert: 23. Mai 2022

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!