So implementieren Sie den Verkauf virtueller Metaframe-Währung in Ihrer Benutzeroberfläche

Sie können virtuelle Währung verkaufen, ohne das Metaframe-Widget zu verwenden. Beispielsweise, wenn Sie Ihre eigene Store-Benutzeroberfläche implementieren oder einen anderen Autorisierungsdienst verwenden möchten. Dazu müssen Sie mithilfe der Metaframe-API die Logik für den Kauf, für das automatische Aufladen des virtuellen Währungsguthabens und für die Anzeige des Nutzerguthabens implementieren.

Voraussetzungen

Nehmen Sie zunächst die erforderlichen Projekteinstellungen vor:

1. Erstellen Sie ein Projekt.
2. Erstellen Sie virtuelle Währungspakete im Kundenportal.
3. Erfragen Sie die nötige ID und den geheimen Schlüssel. Wenden Sie sich dazu an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com oder integration@xsolla.com mit den folgenden Informationen aus dem Kundenportal:

• Händler-ID. Diese finden Sie an folgenden Orten:
  • neben den Namen Ihrer Firma
  • 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/Kundenportal-Abschnitt.

• Projekt-ID. Diese wird neben dem Namen Ihres Projekts angezeigt.

• Ein geheimer Schlüssel zum Signieren von Projekt-Webhooks. Diesen finden Sie unter Projekteinstellungen > Webhooks.

• API-Schlüssel. Dieser 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

Das Xsolla-Team teilt Ihnen die folgenden Informationen mit, die für die weitere Konfiguration erforderlich sind:

• Host-ID
• ID des Xsolla-Konto-OAuth-2.0-Clients
• geheimer Schlüssel des Xsolla-Konto-OAuth-2.0-Clients

Servertoken abrufen

Der Servertoken ist für die automatische Guthabenaufladung erforderlich und um den Benutzerzugriffstoken abzurufen.

Implementieren Sie im Backend Ihrer Anwendung eine Methode zum Abrufen des Server-JWT (JSON Web Token). Nutzen Sie dafür den API-Aufruf JWT generieren. Die Anfrage muss folgende Parameter enthalten:

• grant_type ist der JWT-Typ, übermitteln Sie den Wert client_credentials.
• client_secret ist der geheime Schlüssel, den Sie von Xsolla erhalten haben.
• client_id ist die Client-ID, die Sie von Xsolla erhalten haben.

Benutzerzugriffstoken abrufen

Der Benutzerautorisierungstoken ist erforderlich, um einen Zahlungstoken zu generieren und das virtuelle Währungsguthaben des Nutzers abzufragen.

Wenn Sie Ihr eigenes Autorisierungssystem verwenden, können Sie einen geeigneten Autorisierungstoken abrufen, z. B.:

• den Zugriffstoken eines sozialen Netzwerks
• eine selbst definierte ID – eine auf Ihrem Server generierte Benutzer-ID

Token während der Social-Media-Anmeldung abrufen

1. Richten Sie im Kundenportal ein, dass die Nutzerautorisierung über ein soziales Netzwerk erfolgt:

1. 1. Öffnen Sie Ihr Projekt im Kundenportal.
   2. Klicken Sie in der Seitenleiste auf Login.
   3. Klicken Sie auf Login-Projekt erstellen.
   4. Wählen Sie Standard-Login-Projekt, und klicken Sie auf Erstellen und einrichten. Sobald das neue Login-Projekt erstellt ist, werden Sie zur Seite mit den Login-Projekteinstellungen weitergeleitet.
   5. Wählen Sie im Block Anmeldemethoden die Option Anmeldung über soziale Netzwerke, und klicken Sie auf Konfigurieren.
   6. Verknüpfen Sie die sozialen Netzwerke, über die sich die Nutzer in Ihrer Anwendung anmelden können.
   7. Klicken Sie im Breadcrumb-Pfad auf den Namen Ihres Login-Projekts, um zur Login-Projektseite zurückzukehren.
   8. Scrollen Sie zum Block Sicherheit, und wählen Sie JWT-Signatur aus.
   9. Wählen Sie RS256 als Algorithmus für die Signaturgenerierung aus, und klicken Sie auf Speichern.

2. Implementieren Sie aufseiten Ihres Anwendungs-Clients den Empfang und die Aktualisierung eines Tokens. Nutzen Sie dafür den API-Aufruf Über Zugriffstoken des sozialen Netzwerks authentifizieren.

Token mit selbst definierter ID abrufen

Implementieren Sie im Backend Ihrer Anwendung eine Methode zum Abrufen und Aktualisieren des Tokens. Nutzen Sie dafür den API-Aufruf Über selbst definierte ID authentifizieren. Die Anfrage muss den Header X-Server-Authorization: <server_JWT> enthalten, wobei <server_JWT> der im vorigen Schritt erhaltene Server-JWT ist.

Virtuelle Währung mit API-Aufrufen verwalten