Schnellstart

Integrationsablauf

So integrieren Sie die Payments-Lösung:

1. Erstellen Sie ein Projekt im Kundenportal. Ein Projekt entspricht hierbei einem Spiel. Wenn Sie mehrere Spiele haben, müssen Sie für jedes ein Projekt erstellen.
2. Ergänzen Sie den Katalog aufseiten von Xsolla um Artikel, die Sie verkaufen möchten.
3. Legen Sie eine Bestellung testweise an.
4. Testen Sie den Bezahlvorgang, und richten Sie Benachrichtigungen ein.
5. Unterzeichnen Sie die Xsolla-Lizenzvereinbarung im Kundenportal, um echte Zahlungen abwickeln zu können.

Katalog erstellen

Virtuelle Gegenstände sind Ingame-Inhalte, die ein Nutzer gegen reale und virtuelle Währung kaufen kann. Wenn Sie aufseiten von Xsolla einen Katalog für virtuelle Gegenstände erstellen, können Sie länderspezifische Preise und Beschränkungen festlegen sowie Xsollas System für Werbeaktionen und andere Funktionen nutzen, die regelmäßig erweitert und überarbeitet werden.

Virtuelle Gegenstände erstellen

• Im Kundenportal konfigurieren
• Über API konfigurieren

1. Öffnen Sie Ihr Projekt im Verlagskonto.
2. Klicken Sie in der Seitenleiste auf Online-Shop.
3. Klicken Sie bei Virtuelle Gegenstände auf:
   • Verknüpfen, sofern Sie noch keine virtuellen Gegenstände konfiguriert haben.
   • Konfigurieren Sie, sofern Sie zuvor bereits virtuelle Gegenstände konfiguriert haben.
4. Klicken Sie Artikel anlegen.

5. Machen Sie Angaben zum Artikel. Pflichtfelder:
   • SKU – eindeutige Artikel-ID
   • Gegenstandsname
   • Beschreibung
   • Preise in echter Währung
6. Stellen Sie den Schalter Gegenstand im Store aktivieren auf Ein.
7. Klicken Sie auf Artikel anlegen.

Für die nächsten Schritte benötigen Sie die SKU des erstellten Artikels:

Um virtuelle Gegenstände einzurichten, verwenden Sie API-Aufrufe aus dem Unterabschnitt Admin der Gruppe Virtuelle Gegenstände und Währung.

Hinweis

Lesen Sie den Integrationsleitfaden, um detaillierte Informationen zur Verwendung dieses API-Aufrufs zu erhalten.

Artikelliste abrufen

Um die Liste der Gegenstände zu erhalten, rufen Sie die API-Methode Liste der virtuellen Gegenstände erhalten auf. Übergeben Sie in der Anfrage den Parameter project_id - die Projekt-ID, die Sie im Verlagskonto finden können:

In der Antwort werden detaillierte Informationen über die in Ihrem Projekt erstellten virtuellen Gegenstände übermittelt. Damit Sie anschließend die Bestellung anlegen können, benötigen Sie die Artikel-SKU, die im Parameter items.sku übermittelt wird.

Bestellung anlegen

Eine Bestellung besteht aus Artikeln, die ein Benutzer im Shop kaufen möchte. Nachdem eine Bestellung bezahlt wurde, erhält der Benutzer die Artikel. Um eine Zahlung zu tätigen, muss der Benutzer im Spiel autorisiert sein.

Entscheiden Sie sich für eine Integrationsmethode, die zu Ihrem Spiel passt, um die entsprechende Einrichtungsanleitung anzuzeigen.

• Serverseitig
• Clientseitig

Rufen Sie die API-Methode Zahlungstoken für den Kauf erstellen auf, und übermitteln Sie darin Informationen über den Nutzer und die Artikel. Dieser API-Aufruf eignet sich dazu, sowohl einen Artikel als auch mehrere zu verkaufen.

Übermitteln Sie den Parameter "sandbox": true im Rumpf der Token-abrufen-Anfrage, um in die Testumgebung zu wechseln.

Anfragebeispiel:

Copy

Full screen

Small screen

curl -i -X POST \
  -u 224575:MYAPIKEY \
  https://sandbox-secure.xsolla.com/api/v2/project/224575/admin/payment/token \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "id": {
        "value": "myUserID"
      }
    },
    "purchase": {
      "sandbox": true,
      "items": [
        {
          "sku": "mySKU",
          "quantity": 1
        }
      ]
    }
  }'

Integrieren Sie Xsolla-Login:

1. Erstellen Sie ein Projekt.
2. Konfigurieren Sie Ihr Login-Projekt im Kundenportal.
3. Verknüpfen Sie den Nutzerdatenspeicher.
4. Integrieren Sie die Lösung aufseiten Ihrer Anwendung.

Erstellen und speichern Sie mit der konfigurierten Login-Methode den Authentifizierungstoken, um einen Zahlungstoken zu erhalten. Der Zahlungstoken dient dazu, das Zahlungsportal zu öffnen und die Zahlung abzuwickeln.

Legen Sie eine Bestellung mithilfe des API-Aufrufs Bestellung mit dem angegebenen Artikel erstellen an, um den Zahlungsvorgang zu testen:

1. Wenn Sie einen Test auf der API-Dokumentationswebsite durchführen möchten, klicken Sie auf Try it, um die Oberfläche zum Erstellen einer Anfrage zu öffnen.
2. Geben Sie im Block Security in das Feld Bearer Token den Token ein, den Sie während des Authentifizierungsverfahrens erhalten haben.
3. Geben Sie im Block Body die Bestelldetails ein, z. B. die Artikelmenge. Um die Testumgebung zu nutzen, übermitteln Sie "sandbox": true.
4. Geben Sie im Block Parameters Folgendes an:
   • project_id – Projekt-ID aus dem Kundenportal.
   • item_sku – Artikel-SKU.

Die Antwort enthält Daten, die Sie für die weitere Arbeit benötigen:

• token – Zahlungstoken

Anfragebeispiel:

Copy

Full screen

Small screen

curl -i -X POST \
  'https://store.xsolla.com/api/v2/project/{project_id}/payment/item/{item_sku}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sandbox": true,
    "quantity": 5,
    "settings": {
      "ui": {
        "theme": "63295a9a2e47fab76f7708e1",
      }
    },
    "custom_parameters": {
      "character_id": "ingameUsername"
    }
  }'

Hinweis

Um die Xsolla-API aufzurufen, können Sie die vorgefertigten SDK-Methoden für Spiel-Engines und Plattformen verwenden:

• Unity
• Unreal Engine
• Cocos Creator
• Android

Testkauf durchführen

Zahlungsportal in der Testumgebung öffnen

Um die Benutzeroberfläche in einem neuen Fenster zu öffnen, nutzen Sie die folgende URL: https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN, wobei TOKEN der beim Anlegen einer Bestellung erhaltene Token ist.

Wie Sie das Zahlungsportal anderweitig öffnen können, erfahren Sie in der Dokumentation.

Testzahlung durchführen

1. Rufen Sie das Zahlungsportal in der Testumgebung auf.
2. Wählen Sie Bankkarte als Zahlungsmethode.
3. Geben Sie die Bankkartendaten ein. In die anderen Felder (z. B. Name oder Adresse) können Sie beliebige Daten eingeben. Sie können auch falsche Angaben (Kartennummer oder Ablaufdatum) machen, um zu testen, ob ein Fehler generiert wird.
4. Klicken Sie auf Zahlen.

Liste der Testkarten

Sehen Sie sich die komplette Liste der verfügbaren Testbankkarten an.

Webhooks einrichten

Erfolgte die Integration serverseitig, müssen Sie die angelegten Bestellungen validieren, indem Sie den entsprechenden Code als Antwort auf die Webhooks senden. Erfolgte die Integration aufseiten des Clients, können Sie mithilfe von Webhooks Benachrichtigungen über konfigurierte Ereignisse (z. B. Änderung des Zahlungsstatus) erhalten.

PHP-SDK

Verwenden Sie fertige Klassen für die Verarbeitung von Webhooks.

So richten Sie Webhooks aufseiten von Xsolla ein:

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Projekteinstellungen, und wechseln Sie zur Registerkarte Webhooks.
3. Stellen Sie den Schalter Webhooks auf Ein.
4. Geben Sie die Webhook-URL an.
5. Daraufhin wird standardmäßig ein geheimer Schlüssel zum Signieren der Projekt-Webhooks generiert. Wenn Sie einen neuen geheimen Schlüssel generieren möchten, klicken Sie auf das Aktualisieren-Symbol.
6. Klicken Sie auf Einstellungen speichern.

Um Benachrichtigungen über Benutzervalidierungen und erfolgreiche Zahlungen zu erhalten, konfigurieren Sie die folgenden Webhooks:

• Benutzervalidierung – Benachrichtigung darüber, ob der Nutzer im Spiel registriert ist.
• Zahlung – Benachrichtigung über getätigte Zahlung.

Webhook-Listener konfigurieren

Ein Webhook-Listener ist ein Programmcode, der es ermöglicht, eingehende Webhooks unter einer bestimmten URL-Adresse zu empfangen, eine Signatur zu generieren und dem Xsolla-Webhook-Server zu antworten.

Launch

Lizenzvereinbarung unterschreiben

Wenn Sie die Lizenzvereinbarung unterzeichnen, können Sie echte Zahlungen über alle von Xsolla unterstützten Zahlungsmethoden entgegennehmen. So unterzeichnen Sie die Lizenzvereinbarung:

1. Öffnen Sie das Kundenportal.
2. Navigieren Sie über die Seitenleiste zu Vereinbarungen und Steuern > Vereinbarungen.
3. Klicken Sie auf der Registerkarte Lizenzvereinbarung auf Antragsformular ausfüllen.
4. Geben Sie die Informationen in die entsprechenden Felder ein.

Ihr Antrag wird innerhalb von drei Geschäftstagen geprüft. Sollten während des Prüfverfahrens Fragen auftauchen, wird Xsolla den im Antrag angegebenen Ansprechpartner kontaktieren. Nachdem Xsolla das Prüfverfahren abgeschlossen hat, ändert sich der Vereinbarungsstatus in Unterschrieben.

In die Produktionsumgebung wechseln

Nachdem Sie die vorangegangenen Schritte durchgeführt haben, können Sie echte Zahlungen entgegennehmen:

1. Stellen Sie sicher, dass Sie die Xsolla-Lizenzvereinbarung unterzeichnet haben.
2. Entfernen Sie den Parameter "sandbox": true aus dem Anfragerumpf, wenn Sie einen Token abrufen.
3. Öffnen Sie das Zahlungsportal über den folgenden Link: https://secure.xsolla.com/paystation4/?token=TOKEN.

Diese Seite bewerten

Gibt es etwas, das wir verbessern können? Senden

Jetzt nicht

Vielen Dank für Ihr Feedback!