Artikeldaten-Webhooks einrichten
In einigen Szenarien ist der Empfang von Artikeldaten-Webhooks notwendig, z. B., wenn der Nutzer:
- die Spiel-ID im Backpack eingibt,
- ein Plattformkonto (z. B. Steam) mit dem Backpack verknüpft.
Der Ablauf für den Nutzer beim Empfang von Artikeln im Backpack wird abhängig von den Projekteinstellungen und Artikelparametern automatisch festgelegt.
Damit die Informationen über den Artikel, den der Nutzer über den Backpack erhalten hat, auf den Spielserver gelangen, müssen Sie Webhooks von den Xsolla-Servern empfangen und verarbeiten können:
- Konfigurieren Sie Ihr Projekt so, dass es Webhooks empfangen kann:
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Projekteinstellungen, und wechseln Sie zur Registerkarte Webhooks.
- Geben Sie im Feld Webhook-Server die URL ein, an die Xsolla die Webhooks senden soll.
- Kopieren und speichern Sie den Wert aus dem Feld Geheimer Schlüssel. Dieser Schlüssel wird standardmäßig generiert und dient dazu, Webhooks zu signieren. Wenn Sie ihn ändern möchten, klicken Sie auf das Aktualisieren-Symbol.
- Klicken Sie auf Webhooks aktivieren.
Im Kundenportal kann nur eine Serveradresse für Webhooks angegeben werden.
Wenn Sie bereits einen Webhook für den Verkauf Ihrer eigenen virtuellen Währung über das Metaframe-Widget eingerichtet haben, kontaktieren Sie Ihren Customer Success Manager, oder senden Sie eine E-Mail mit den folgenden Informationen an csm@xsolla.com:
- Händler-ID. Diese finden Sie im Kundenportal an mehreren Orten:
- unter Firmeneinstellungen > Firma,
- in der Adresszeile des Browsers auf einer beliebigen Seite im Kundenportal. Die URL weist das folgende Format auf:
https://publisher.xsolla.com/<merchant ID>/<Publisher Account section>.
- Projekt-ID. Diese wird im Kundenportal neben dem Projektnamen angezeigt.
- URL des Webhook-Servers
- Implementieren Sie die Verarbeitung der folgenden Webhooks:
Um den Empfang des Webhooks zu bestätigen, muss Ihr Server wie folgt antworten:
- HTTP-Statuscode 200 ohne Nachrichtenrumpf
- HTTP-Statuscode 404 mitsamt Problembeschreibung, sofern der angegebene Nutzer nicht gefunden oder eine ungültige Signatur übermittelt wurde
- HTTP-Statuscode 500 mitsamt Problembeschreibung, sofern es vorübergehende Probleme auf Ihrem Server gibt
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
