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.

Discord-Server
Treten Sie mit dem Xsolla-Team und Entwicklern, die Xsolla-Produkte nutzen, in Kontakt.

Integrationsablauf

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

  1. Installieren Sie das Plug-in.
  2. Konfigurieren Sie das Projekt im Kundenportal.
  3. Richten Sie einen Ingame-Shop und einen Produktkatalog auf Ihrem Server ein.
  4. Richten Sie Ihr UE4-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.

Note
In diesem Leitfaden werden die minimalen Einstellungen beschrieben, die für den Schnellstart des Moduls erforderlich sind. Bei Fragen wenden Sie sich bitte an Ihren Account Manager.

Plug-in installieren

  1. Laden Sie den Epic Games Launcher herunter.
  2. Erstellen Sie ein neues UE4-Projekt.
  3. Laden Sie das Plug-in aus dem Unreal Engine Marketplace oder von GitHub herunter.

Starten Sie nach der Installation des Plug-ins die Demo-Maps aus dem Verzeichnis Content Browser > Xsolla Content > Maps. Demo-Maps veranschaulichen die Funktionen des Plug-ins und stellen eine Möglichkeit dar, die Anwendungslogik zu implementieren.

Für Demos-Maps existieren ein voreingestelltes Projekt und ein vollständig konfigurierter Ingame-Online-Shop im Kundenportal.

Standardwerte für Demo-Maps:

KeyValue
Login-ID026201e3-7e40-11ea-a85b-42010aa80004
Projekt-ID77640

Demo-Maps lassen 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

Projekt im Kundenportal einrichten

  1. Registrieren Sie sich im Kundenportal.
  2. Konfigurieren Sie das automatisch nach der Registrierung im Kundeportal erstellte Projekt:
    1. Wählen Sie im Abschnitt Projekte Ihr Projekt aus, und wechseln Sie in die Projekteinstellungen.
    2. Fügen Sie in der Registerkarte Allgemeine Einstellungen Folgendes hinzu:
      • Bild (optional)
      • Projektsprachen (Englisch ist voreingestellt)
      • Jeweiliger Projektname für alle ausgewählten Sprachen
      • Spiel-Website (optional)
      • Projektbeschreibung (optional)
    3. Klicken Sie auf Speichern.

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.

  • Projekt-ID. Diese finden Sie unter Projekteinstellungen > Projekt-ID.

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

UE4-Projekt einrichten

  1. Öffnen Sie Ihr UE4-Projekt in Unreal Editor.
  2. Gehen Sie bei Blueprint-Projekten wie folgt vor:
    1. Kompilieren Sie das UE4-Projekt.
    2. Wechseln Sie zum Content Browser, und fügen Sie eine New C++ Class mit None als Elternknoten hinzu.

  1. Navigieren Sie zu Settings > Plugins > Installed > Xsolla Store SDK. Aktivieren Sie das Kontrollkästchen bei Enabled, und klicken Sie auf die Schaltfläche Restart Now, um die Einstellungen zu speichern und Unreal Editor neu zu laden.

  1. Navigieren Sie zu Content Browser > View Options, und aktivieren Sie die Kontrollkästchen bei Show Engine Content und Show Plugin Content.

  1. 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 UMG UI-Dokumentation.
  2. Richten Sie die Ereignisbehandlung gemäß Ihrer Anwendungslogik mithilfe der SDK-Methoden ein.

Note
Befolgen Sie die Anleitung für die SDK-Modifizierung, um das SDK für Ihre Anwendung zu modifizieren.

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.

Note
Sie können zusätzliche Informationen im Parameter custom_parameters übermitteln. Diese Informationen werden auch in den konfigurierten Webhooks übermittelt.

Zahlungsportal öffnen

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

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.

  1. Speichern Sie die Einstellungen.
  2. Implementieren Sie folgende Webhooks für die Bezahlstation:

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

  1. Testen Sie den Webhook-Handler.

Note
Um den Empfang eines Webhooks zu bestätigen, muss Ihr Server wie folgt antworten:
  • HTTP-Statuscode 204 ohne Nachrichtenrumpf
  • HTTP-Statuscode 400 samt Problembeschreibung, sofern der angegebene Benutzer nicht gefunden oder eine ungültige Signatur übermittelt wurde
Mehr zu Webhooks, inklusive Beispiele, erfahren Sie in der API-Referenz.

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

  1. Klicken Sie auf Speichern.

Zahlungsvorgang testen

Testen Sie nach erfolgreicher Konfiguration des Plug-ins 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 mit echten Zahlungen:

  1. Stellen Sie sicher, dass Sie einen Vertrag mit Xsolla geschlossen haben.
  2. Deaktivieren Sie in Ihrem UE4-Projekt das Kontrollkästchen Sandbox unter Settings > Project Settings > Plugins > Xsolla Payments.
  3. Legen Sie im Rahmen der Tokenanfrage für den Parameter sandbox den Wert false fest.

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!
Letztmalig aktualisiert: 25. Juni 2021

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!