Benutzern Käufe gewähren

Implementieren Sie, dass den Nutzern in Ihrer Anwendung Käufe gewährt werden, indem Sie die in den Webhooks von Xsolla empfangenen Informationen (Transaktionsdetails und gekauften Artikel) verwenden.

Für den Kauf und die Rückgabe von Artikeln hat Xsolla zwei Webhook-Empfangsoptionen eingerichtet: Zahlungs- und Transaktionsdaten sowie Informationen über gekaufte Artikel können etnweder separat oder zusammengefasst in einem Webhook gesendet werden.

Weitere Informationen in Bezug auf Empfangsoptionen von Webhooks

Empfang von Informationen in kombinierten Webhooks:

Wenn Sie sich nach dem 22. Januar 2025 im Kundenportal registriert haben, erhalten Sie alle Informationen in den Webhooks Erfolgreiche Bezahlung der Bestellung (order_paid) und Stornierung der Bestellung (order_canceled). In diesem Fall müssen Sie die Webhooks Zahlung (payment) und Erstattung (refund) nicht verarbeiten.

Empfang von Informationen in separaten Webhooks:

Wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, erhalten Sie die folgenden Webhooks:

Zahlung (payment) und Erstattung (refund) mit Informationen über die Zahlungsdaten und den Transaktionsdetails.
Erfolgreiche Bezahlung der Bestellung (order_paid) und Stornierung der Bestellung (order_canceled) mit Informationen über gekaufte Artikel.

Sie müssen alle eingehenden Webhooks verarbeiten.

Um zur neuen Option mit dem Empfang von kombinierten Webhooks zu wechseln, wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.

Für die volle Operation des In-Game Stores und Zahlungsmanagements ist es notwendig, die Verarbeitung des Hauptwebhooks zu implementieren:

Webhook-Name	Beschreibung
Beutzervalidierung > Benutzervalidierung (`user_validation`)	Wird während der verschiedenen Phasen des Bezahlvorgangs gesendet, um sicherzustellen, dass der Nutzer im Spiel registriert ist.
Spieledienste > Kombinierte Webhooks > Erfolgreiche Bezahlung der Bestellung (`order_paid`)	Es enthält Zahlungsdaten, Transaktionsdetails und Informationen über gekaufte Artikel. Nutzen Sie die Daten des Webhooks, um Artikel zum Benutzer hinzuzufügen.
Spieledienste > Kombinierte Webhooks > Stornierung der Bestellung (`order_canceled`)	Es enthält Daten von der stornierten Zahlung, Transaktionsdetails und Informationen über gekaufte Artikel. Nutzen Sie die Daten des Webhooks, um die gekauften Gegenstände zu entfernen.

Das folgende Schema zeigt Ablauf beim Kauf und bei der Rückgabe von Artikeln mithilfe von Webhooks aus der Liste.

Webhook-Name	Beschreibung
Beutzervalidierung > Benutzervalidierung (`user_validation`)	Wird während der verschiedenen Phasen des Bezahlvorgangs gesendet, um sicherzustellen, dass der Nutzer im Spiel registriert ist.
Zahlungen > Zahlung (`payment`)	Es enthält Zahlungsdaten und Transaktionsdetails.
Spieledienste > Separate Webhooks >Erfolgreiche Bezahlung der Bestellung (`order_paid`)	Es enthält Informationen über gekaufte Artikel und die Transaktionsdetails. Nutzen Sie die Daten des Webhooks, um Artikel zum Benutzer hinzuzufügen.
Zahlungen > Erstattung (`refund`)	Es enthält Zahlungsdaten und Transaktionsdetails.
Spieledienste > separate Webhooks > Stornierung der Bestellung (`order_canceled`)	Es enthält Informationen über den gekauften Artikel und die ID der stornierten Transaktion. Nutzen Sie die Daten aus dem Webhook, um dem Benutzer den gekauften Artikel zu entziehen.

Das folgende Schema zeigt Ablauf beim Kauf und bei der Rückgabe von Artikeln mithilfe von kombinierten Webhooks aus der Liste.

Ist die Artikelkatalog personalisierung aufseiten Ihrer Anwendung implementiert, richten Sie die Verarbeitung der Katalogpersonalisierung aufseiten des Partners ein.

Um echte Zahlungen entgegennehmen zu können, müssen Sie lediglich die Lizenzvereinbarung unterzeichnen und die Verarbeitung der folgenden Webhooks implementieren:

Zahlung, Erfolgreiche Bezahlung der Bestellung und Benutzervalidierung, sofern Sie separate Webhooks empfangen
Erfolgreiche Bezahlung der Bestellung und Benutzervalidierung, sofern Sie kombinierte Webhooks empfangen

Webhooks im Kundenportal einrichten

Ö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 Ihres Servers an, auf dem Sie Webhooks im Format https://example.com empfangen möchten. Sie können auch eine URL aus einem Tool, mit dem sich Webhooks testen lassen, angeben.
Standardmäßig wird ein geheimer Schlüssel zum Signieren von Projekt-Webhooks generiert. Wenn Sie einen neuen geheimen Schlüssel generieren möchten, klicken Sie auf das Aktualisieren-Symbol.
Klicken Sie auf Webhooks aktivieren.

Für die Datenübertragung wird das HTTPS-Protokoll verwendet; das HTTP-Protokoll wird nicht unterstützt.

Webhooks im Kundenportal testen

Sofern die Webhooks erfolgreich eingerichtet sind, wird ein entsprechender Testblock unter dem Einrichtungsblock angezeigt.

Der Testbereich im Kundenportal variiert je nach der Empfangsoption für Webhooks.

Name der Registerkarte für Webhook-Tests	Webhook-Name und -Typ
Payments und Store	Beutzervalidierung > Benutzervalidierung (`user_validation`)
	Spieledienste > Kombinierte Webhooks > Erfolgreiche Bezahlung der Bestellung (`order_paid`)
	Spieledienste > Kombinierte Webhooks > Stornierung der Bestellung (`order_canceled`)
Abonnements	Beutzervalidierung > Benutzervalidierung (`user_validation`)
	Zahlungen > Zahlung (`payment`)

Name der Registerkarte für Webhook-Tests	Webhook-Name und -Typ
Store	Spieledienste > Separate Webhooks >Erfolgreiche Bezahlung der Bestellung (`order_paid`)
	Spieledienste > separate Webhooks > Stornierung der Bestellung (`order_canceled`)
Zahlungen	Beutzervalidierung > Benutzervalidierung (`user_validation`)
	Zahlungen > Zahlung (`payment`)
Abonnements	Beutzervalidierung > Benutzervalidierung (`user_validation`)
	Zahlungen > Zahlung (`payment`)

Falls reale Werte fehlen, können Sie beliebige Werte eingeben.

Außerdem können Sie Webhooks testen, wenn Sie Käufe in der Testumgebung oder im Live-Modus tätigen. Erstattungen lassen sich nur im Live-Modus testen.

Dem Webhook antworten

Um den Empfang eines Webhooks zu bestätigen, muss Ihr Server wie folgt antworten:

HTTP-Statuscode 200, 201 oder 204 ohne Nachrichtenrumpf im Falle einer positiven Antwort.
HTTP-Statuscode 400 samt Problembeschreibung, sofern der angegebene Benutzer nicht gefunden oder eine ungültige Signatur übermittelt wurde.

Ihr Webhook-Handler kann ebenso mit einem HTTP-Statuscode 5xx antworten, falls Ihr Server vorübergehend Probleme hat.

Die vollständige Liste und der Mechanismus der Webhook sowie detaillierte Beispiele für deren Verarbeitung sind in der Webhooks-Dokumentation beschrieben.

Nächste Schritte

Nützliche Links

Integrationsablauf

Vielen Dank für Ihr Feedback!

Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.

Letztmalig aktualisiert: 23. Januar 2025

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Your browser is not supported. Please try a different browser