Serverseitige Integration

Dieser Integrationstyp eignet sich für Partner, die die Spiellogik für die Autorisierung, den Ingame-Shop und das Spielerinventar bereits auf ihren Servern implementiert haben und die Xsolla-Bezahlstation nutzen möchten. Dazu müssen Sie den Zugriffstoken der Bezahlstation abrufen und die Handhabung von Webhooks konfigurieren.

Bei der Serverintegration wird die folgende Logik für die Zahlungsabwicklung implementiert:

1. Der Client sendet eine Anfrage an den Anwendungsserver, um die Zahlungsschnittstelle zu öffnen.
2. Der Anwendungsserver sendet Informationen über die Zahlungswährung und den ‑betrag an den Xsolla-Server.
3. Der Xsolla-Server gibt einen Token mit den Kaufdetails und den Bezahlstation-Parametern zurück.
4. Der Anwendungsserver sendet den empfangenen Token an den Client.
5. Der Client öffnet die Bezahlstation in einem Browser mithilfe des SDK.
6. Nach dem der Bezahlvorgang abgeschlossen ist, wird ein Webhook mit dem Zahlungsstatus an den Anwendungsserver gesendet.

Integrationsablauf

So integrieren Sie Xsolla-Produkte in Ihre Server mithilfe des Game Commerce-Assets:

1. Installieren Sie das Asset.
2. Konfigurieren Sie das Projekt im Kundenportal.
3. Richten Sie einen Ingame-Shop und einen Produktkatalog auf Ihrem Server ein.
4. Richten Sie Ihr Unity-Projekt ein.
5. Rufen Sie einen Token ab.
6. Öffnen Sie das Zahlungsportal.
7. Richten Sie das Webhook-Handling ein.

Testen Sie den Zahlungsvorgang nach Abschluss der Integration.

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.

Asset installieren

1. Unity herunterladen.
2. Wählen Sie je nach Ihren Vorlieben eine persönliche oder berufliche Unity-Lizenz.
3. Erstellen Sie ein neues Unity-Projekt.
4. Laden Sie das Asset herunter.
5. Entpacken Sie das Paket.
6. Gehen Sie im Unity-Editor im Hauptmenü auf Assets > Import Package > Custom Package und wählen Sie das Asset aus.
7. Stellen Sie sicher, dass der Mono-Compiler für die Erstellung eines Spiel-Builds verwendet wird (nur für Standalone-Builds). Um dies zu tun:

1. 1. Klicken Sie im Hauptmenü auf Edit > Project Settings.
   2. Gehen Sie zum Abschnitt Other Settings > Configuration.
   3. Stellen Sie sicher, dass Mono im Feld Scripting Backend ausgewählt ist.

Starten Sie nach der Installation des Assets die Xsollus-Demoszene aus dem Verzeichnis Assets > Xsolla > DemoCommon > Scene. Die Demoszene veranschaulicht die Funktionen des Assets und stellt eine Möglichkeit, die Anwendungslogik zu implementieren.

Für die Demoszene existiert ein voreingestelltes Projekt und ein vollständig konfigurierter Ingame-Online-Shop im Kundenportal.

Standardwerte für die Xsollus-Demoszene:

Die Demoszene lässt sich auf zwei Wege nutzen:

• als Beispiel
• als erste Version bzw. als Ausgangspunkt für das Anmeldesystem, das Inventar und den Ingame-Shop, um zügig Ergebnisse zu erzielen und deren jeweilige Funktionen bei Bedarf zu erweitern

Um die Demoszene oder Teile davon in Ihrer Anwendung zu verwenden, fügen Sie sie in den Build-Einstellungen hinzu:

1. Navigieren Sie zu Assets > Xsolla > DemoCommon > Scene, und starten Sie die Xsollus-Szene.
2. Öffnen Sie File > Build settings, und klicken Sie auf Add Open Scenes.

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 (Englisch ist vorausgewählt)
      • Projektname für alle angegebenen Sprachen
      • Spielwebsite (optional)
   3. Klicken Sie auf Projekt erstellen.

Bei der Integration benötigen Sie die folgenden Parameter:

• Händler-ID. Diese finden Sie unter Projekteinstellungen > Webhooks.

• API-Schlüssel. Diesen finden Sie unter Firmeneinstellungen > API-Schlüssel.

• Die Projekt-ID wird im Kundenportal neben dem Projektnamen angezeigt.

• Geheimer Schlüssel. Diesen finden Sie unter Projekteinstellungen > Webhooks.

Unity-Projekt einrichten

1. Öffnen Sie Ihr Unity-Projekt.
2. Klicken Sie im Hauptmenü auf Window > Xsolla > Edit Settings.
3. Um die Testumgebung zu aktivieren, setzen Sie im Inspector-Fensterbereich ein Häkchen bei Enable sandbox?.

4. Gestalten Sie eine Benutzeroberfläche für das Anmeldesystem, den Ingame-Shop und sonstige Seiten Ihrer Anwendung. Sie können Ihre eigene Lösung erstellen, befolgen Sie dazu die Unity-Anleitung.
5. Richten Sie die Ereignisbehandlung gemäß Ihrer Anwendungslogik mithilfe der SDK-Methoden ein.

Token abrufen

Nutzen Sie den API-Aufruf Create payment token by server, um einen Token zu beziehen. Ihr Server sollte eine Anfrage samt folgender Daten an den Xsolla-Server senden:

• die ID des Benutzers, der den Kauf getätigt hat
• Zahlungsbetrag
• Zahlungswährung
• Kaufangaben (optional)
• Bezahlstation-Parameter (optional)

Sie können die Kaufinformationen auf eine der folgenden Weisen übermitteln:

• als Liste der Artikel über den Parameter item
• als Beschreibung des Kaufs über den Parameter description

Bezahlstation-Parameter (z. B. Lokalisierungssprache, Eigenschaften der Benutzeroberfläche, Theme) werden im settings-Objekt übermittelt. Um die Testumgebung zu aktivieren/deaktivieren, müssen Sie den Wert des Parameters sandbox in der Tokenanfrage sowie die SDK-Einstellungen ändern. Um die restlichen Einstellungen der Bezahlstation-Benutzeroberfläche zu ändern, müssen Sie den Parameter der Tokenanfrage ändern.

Zahlungsportal öffnen

Um das Zahlungsportal zu öffnen, übermitteln Sie den im vorherigen Schritt bezogenen Token an die SDK-Methode OpenPurchaseUi.

Webhooks einrichten

1. Wechseln Sie zu Ihrem Projekt im Kundenportal.
2. Navigieren Sie zu Projekteinstellungen > Webhooks, geben Sie die Webhook-URL an, und generieren Sie einen geheimen Schlüssel, um Projekt-Webhooks signieren zu können.

3. Speichern Sie die Einstellungen.
4. Implementieren Sie folgende Webhooks für die Bezahlstation:
   • Benutzervalidierung
   • Zahlung
   • Erstattung

5. Wechseln Sie zur Registerkarte Checkout, und klicken Sie auf Verknüpfen.

6. Testen Sie den Webhook-Handler.

7. Klicken Sie im seitlichen Menü auf Bezahlstation, und wechseln Sie anschließend zur Registerkarte Einstellungen.
8. Stellen Sie den Umschalter für die Option Checkout auf Ein.

9. Klicken Sie auf Speichern.

Zahlungsvorgang testen

Testen Sie nach erfolgreicher Konfiguration der Assets den Zahlungsvorgang. Standardmäßig werden alle Zahlungen für sämtliche Benutzer 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 mit echten Zahlungen:

1. Stellen Sie sicher, dass Sie einen Vertrag mit Xsolla geschlossen haben.
2. Deaktivieren Sie in Ihrem Unity-Projekt das Kontrollkästchen Enable sandbox? im Inspector-Fensterbereich.
3. Legen Sie im Rahmen der Tokenanfrage für den Parameter sandbox den Wert false fest.