# Webhooks

# Überblick

Webhooks sind Benachrichtigungen über Ereignisse im System. Wenn ein bestimmtes 
Ereignis eintritt, sendet Xsolla eine HTTP-Anfrage mitsamt den Ereignisdaten an 
Ihre Anwendung. In der Regel handelt es sich dabei um eine POST-Anfrage im JSON-
Format.

<strong>Ereignisbeispiele:</strong>
- Nutzer interagiert mit einem Artikelkatalog
- Bestellung wird bezahlt oder storniert

Wenn ein bestimmtes Ereignis eintritt, benachrichtigt Xsolla Ihr System per 
Webhook. Infolgedessen können Sie Aktionen einleiten, wie zum Beispiel:
- das Guthaben eines Nutzers aufladen
- eine Zahlung erstatten
- dem Nutzerkonto neue Artikel gewähren oder Artikel aus dem Nutzerkonto entfernen
- ein Abonnement aktivieren
- einen Nutzer bei Betrugsverdacht sperren

<b>Beispielhafter Webhook-Ablauf bei der Zahlungsabwicklung:</b>

![Webhook für die 
Zahlungsabwicklung](https://cdn.xsolla.net/developers/current/images/api_docs/webhooks-general.svg)

<div class="note">
<p><strong>Hinweis</strong></p><p>Je nach verwendeter Lösung und Art der Integration können die Webhooks und die Interaktionsabfolge vom angegebenen Beispiel abweichen.</p>
</div>

<b>Videoanleitung für die Xsolla-Webhook-Integration:</b>

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; border-radius: 15px; overflow: hidden;">
  <iframe src="https://player.vimeo.com/video/1034591338" style="position: absolute; top:0; left: 0; width: 100%; height: 100%; border:0; border-radius: 15px;" allowfullscreen></iframe>
</div>


<b>Webhooks-Einstellungen beim Arbeiten mit Xsolla-Produkten und ‑Lösungen:</b>

<table>
<thead>
    <tr>
        <th>Produkt/Lösung</th>
        <th>Erforderlich/Optional</th>
        <th>Wozu die Webhooks verwendet werden</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>Payments</td>
        <td>Erforderlich</td>
        <td>
          <ul>
            <li>Benutzervalidierung.</li>
            <li>Transaktionsdetails im Falle einer erfolgreichen Zahlung oder Zahlungserstattung erhalten</li>
            <li>gekaufte Artikel einem Nutzer gewähren und im Falle einer Stornierung der Bestellung die Artikel entfernen</li>
          </ul>
        </td>
    </tr>
    <tr>
        <td>In-Game Store</td>
        <td>Erforderlich</td>
        <td>
          <ul>
            <li>Benutzervalidierung.</li>
            <li>Transaktionsdetails im Falle einer erfolgreichen Zahlung oder Zahlungserstattung erhalten</li>
            <li>gekaufte Artikel einem Nutzer gewähren und im Falle einer Stornierung der Bestellung die Artikel entfernen</li>
          </ul>
        </td>
    </tr>
    <tr>
        <td>Game Sales</td>
        <td>Optional</td>
        <td>Für den Verkauf von Spielschlüsseln sind keine Benutzervalidierung und keine Gewährung von Artikeln erforderlich. Dennoch können Sie Webhooks nutzen, wenn Sie Informationen über Ereignisse erhalten möchten, z. B., wenn eine Bestellung bezahlt oder storniert wird.<br />Wenn Sie sich für Webhooks entscheiden, ist es wichtig, alle eingehenden <a href="/de/webhooks/overview/#section/List-of-required-webhooks">erforderlichen Webhooks</a> zu verarbeiten.
</td>
    </tr>
    <tr>
        <td>Subscriptions</td>
        <td>Optional</td>
        <td>Zum Abrufen von Informationen über den Abschluss, die Aktualisierung oder die Kündigung eines Abonnements. Alternativ können Sie die <a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_information_set_up_via_api">Informationen auch über die API anfordern</a>.
</td>
    </tr>
    <tr>
        <td>Web Shop</td>
        <td>Erforderlich</td>
        <td>
          <ul>
            <li>Benutzervalidierung.</li>
            <li>Transaktionsdetails im Falle einer erfolgreichen Zahlung oder Zahlungserstattung erhalten</li>
            <li>gekaufte Artikel einem Nutzer gewähren und im Falle einer Stornierung der Bestellung die Artikel entfernen</li>
            <li>Für die Benutzerauthentifizierung, wenn Sie Benutzer über deren ID authentifizieren. Alternativ dazu können Sie <a href="/solutions/web-shop/authentication-and-analytics/set-up-authentication/#web_shop_guide_shop_with_auth_set_up_auth_xsolla_login_how_to_get_it">Benutzer über Xsolla Login authentifizieren</a>.</li>
          </ul>
        </td>
    </tr>
    <tr>
        <td>Digital Distribution Hub</td>
        <td>Erforderlich</td>
        <td>
          <ul>
            <li>Benutzervalidierung.</li>
            <li>Transaktions-ID aufseiten von Xsolla mit der Transaktions-ID in Ihrem System verknüpfen</li>
            <li>zusätzliche Transaktionsparameter in der Bestellung übermitteln</li>
            <li>gekaufte Artikel einem Nutzer gewähren und im Falle einer Stornierung der Bestellung die Artikel entfernen</li>
          </ul>
          <p>Ausführliche Informationen zum Einrichten von Webhooks für den Digital Distribution Hub finden Sie in der <a href="/solutions/ddh/#integration_guide_ddh_webhook">Dokumentation</a>.</p>
        </td>
    </tr>
    <tr>
        <td>Login</td>
        <td>Optional</td>
        <td>
          <p>Empfang von Ereignisinformationen:</p>
          <ul>
            <li>Benutzerregistrierung/-autorisierung</li>
            <li>Bestätigung der E-Mail-Adresse des Benutzers</li>
            <li>Verknüpfung eines Social-Media-Kontos des Benuters</li>
          </ul>
          <p>Ausführliche Informationen zur Einrichtung von Webhooks finden Sie in der <a href="/api/login/operation/add-webhook-for-event/">-Login-Dokumentation</a>.</p>
        </td>
    </tr>
</tbody>
</table>

# Liste der erforderlichen Webhooks
Wenn Sie Produkte und Lösungen verwenden, die Webhooks erfordern, müssen Sie 
die <a href="/webhooks/overview/#section/Set-up-webhooks-in-Publisher-
Account">Webhooks in Ihrem Kundenportal aktivieren, testen</a> und <a 
href="/webhooks/overview/#section/Webhook-listener">deren Verarbeitung 
einrichten</a>. Wenn bestimmte Ereignisse eintreten, werden die Webhooks der 
Reihe nach gesendet. Wenn Sie also einen der Webhooks nicht verarbeiten, werden 
die nachfolgenden Webhooks nicht gesendet. Die Liste der erforderlichen 
Webhooks finden Sie unten.

## In-Game Store und Payments
Für den Kauf und die Rückgabe von Artikeln auf der Website hat Xsolla zwei 
Webhook-Sendeoptionen eingerichtet: Informationen über Zahlungs- und 
Transaktionsdaten sowie Informationen über gekaufte Artikeln können entweder 
separat oder zusammengefasst in einem Webhook gesendet werden.

<b>Empfang von Informationen in kombinierten Webhooks:</b>

Wenn Sie sich nach dem 22. Januar 2025 im <a 
href="https://publisher.xsolla.com/">Kundenportal</a> registriert haben, werden 
alle Informationen in den Webhooks <a href="/webhooks/operation/successful-
order-payment">Erfolgreiche Bezahlung der Bestellung</a> (`order_paid`) und <a 
href="/webhooks/operation/order-cancellation">Stornierung der Bestellung</a> 
(`order_canceled`) übermittelt. In diesem Fall müssen Sie die Webhooks <a 
href="/webhooks/operation/payment">Zahlung</a> (`payment`) und <a 
href="/webhooks/operation/refund">Erstattung</a> (`refund`) nicht verarbeiten.

<b>Empfang von Informationen in separaten Webhooks:</b>

Wenn Sie sich am oder vor dem 22. Januar 2025 im <a 
href="https://publisher.xsolla.com/">Kundenportal</a> registriert haben, 
empfangen Sie die folgenden Webhooks:
- <a href="/webhooks/operation/payment">Zahlung</a> (`payment`) und <a 
  href="/webhooks/operation/refund">Erstattung</a> (`refund`) mit Informationen 
  über die Zahlungsdaten und   Transaktionsdetails.
- <a href="/webhooks/operation/successful-order-payment-separate">Erfolgreiche 
  Bezahlung der Bestellung</a> (`order_paid`) und <a href="/webhooks/operation
  /order-cancellation-separate">Stornierung der Bestellung</a> (`order_canceled`) 
  mit Informationen über die gekauften Artikel.

Sie müssen alle eingehenden Webhooks verarbeiten. Wenn Sie auf die neue Option 
(Empfang kombinierter Webhooks) umsteigen möchten, wenden Sie sich an Ihren 
Customer Success Manager oder senden Sie eine E-Mail an <a 
href="mailto:csm@xsolla.com">csm@xsolla.com</a>.

Damit In-Game Store und die Zahlungsverwaltung uneingeschränkt funktionieren, 
muss die Verarbeitung der wichtigsten Webhooks implementiert sein.

<b>Beim Empfang kombinierter Webhooks:</b>

<table>
<thead>
    <tr>
        <th>Webhook-Name und ‑Typ</th>
        <th>Beschreibung</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>Benutzervalidierung &gt; <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> (<code>user_validation</code>)</td>
        <td>Wird in verschiedenen Phasen des Zahlungsvorgangs gesendet, um sicherzustellen, dass der Nutzer im Spiel registriert ist.</td>
    </tr>
    <tr>
        <td>Spieldienste &gt; kombinierte Webhooks &gt; <a href="/webhooks/operation/successful-order-payment">Erfolgreiche Bezahlung der Bestellung</a> (<code>order_paid</code>)</td>
        <td>Enthält Zahlungsdaten, Transaktionsdetails und Informationen über gekaufte Artikel. Verwenden Sie die Daten aus dem Webhook, um dem Nutzer Artikel zu gewähren.</td>
    </tr>
    <tr>
        <td>Spieldienste &gt; kombinierte Webhooks &gt; <a href="/webhooks/operation/order-cancellation">Stornierung der Bestellung</a> (<code>order_canceled</code>)</td>
        <td>Enthält Daten der stornierten Zahlung, Transaktionsdetails und Informationen über die gekauften Artikel. Verwenden Sie die Daten aus dem Webhook, um die gekauften Artikel zu entfernen.</td>
    </tr>
</tbody>
</table>


<b>Beim Empfang separater Webhooks:</b>

<table>
<thead>
    <tr>
        <th>Webhook-Name und ‑Typ</th>
        <th>Beschreibung</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>Benutzervalidierung &gt; <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> (<code>user_validation</code>)</td>
        <td>Wird in verschiedenen Phasen des Zahlungsvorgangs gesendet, um sicherzustellen, dass der Nutzer im Spiel registriert ist.</td>
    </tr>
    <tr>
        <td>Zahlungen &gt; <a href="/webhooks/operation/payment">Zahlung</a> (<code>payment</code>)</td>
        <td>Enthält Zahlungsdaten und Transaktionsdetails.</td>
    </tr>
    <tr>
        <td>Spieldienste &gt; separate Webhooks &gt; <a href="/webhooks/operation/successful-order-payment-separate">Erfolgreiche Bezahlung der Bestellung</a> (<code>order_paid</code>)</td>
        <td>Enthält Informationen über gekaufte Artikel. Verwenden Sie die Daten aus dem Webhook, um dem Nutzer Artikel hinzuzufügen.</td>
    </tr>
    <tr>
        <td>Zahlungen &gt; <a href="/webhooks/operation/refund">Erstattung</a> (<code>refund</code>)</td>
        <td>Enthält Zahlungsdaten und Transaktionsdetails.</td>
    </tr>
    <tr>
        <td>Spieldienste &gt; separate Webhooks &gt; <a href="/webhooks/operation/order-cancellation-separate">Stornierung der Bestellung</a> (<code>order_canceled</code>)</td>
        <td>Enthält Informationen über die gekauften Artikel und die ID der stornierten Transaktion. Verwenden Sie die Daten aus dem Webhook, um die gekauften Artikel zu entfernen.</td>
    </tr>
</tbody>
</table>

Falls die Artikelkatalog<a href="/doc/in-game-
store/features/personalization">personalisierung</a> aufseiten Ihrer Anwendung 
implementiert ist, müssen Sie den Webhook <a href="/webhooks/operation
/personalized-partner-catalog">Katalogpersonalisierung aufseiten des 
Partners</a> einrichten.

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Um echte Zahlungen entgegennehmen zu können, müssen Sie lediglich <a href="/doc/in-game-store/integration-guide/sign-licensing-agreement/">die Lizenzvereinbarung unterzeichnen</a> und die Verarbeitung der folgenden Webhooks implementieren:</p>
<p><ul><li><a href="/webhooks/operation/payment">Zahlung</a>, <a href="/webhooks/operation/successful-order-payment-separate">Erfolgreiche Bezahlung der Bestellung</a> und <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a>, sofern Sie separate Webhooks empfangen</li><li><a href="/webhooks/operation/successful-order-payment">Erfolgreiche Bezahlung der Bestellung</a> und <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a>, sofern Sie kombinierte Webhooks empfangen</li></ul></p>
</div>

## Subscriptions
Um Abo-Modelle automatisch zu verwalten, muss die Verarbeitung der wichtigsten 
Webhooks implementiert sein:
- <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> 
  (`user_validation`) – wird in verschiedenen Phasen des Bezahlvorgangs gesendet, 
  um sicherzustellen, dass der Nutzer im Spiel registriert ist.
- <a href="/webhooks/operation/payment">Zahlung</a> (`payment`) – wird gesendet, 
  wenn eine Bestellung bezahlt wird, und enthält Zahlungsdaten sowie 
  Transaktionsdetails.
- <a href="/webhooks/operation/created-subscription/">Abgeschlossenes 
  Abonnement</a> (`create_subscription`) – wird gesendet, wenn ein Webhook vom 
  Typ <a href="/webhooks/operation/payment">Zahlung</a> erfolgreich verarbeitet 
  wurde oder der Nutzer ein Probeabo abgeschlossen hat. Der Webhook enthält 
  Details über das abgeschlossene Abonnement und die Nutzerdaten. Verwenden Sie 
  die Webhook-Daten, um das Abonnement für den Nutzer zu aktivieren.
- <a href="/webhooks/operation/updated-subscription/">Aktualisiertes 
  Abonnement</a> (`update_subscription`) – wird gesendet, wenn ein Abonnement 
  verlängert oder geändert und Webhook vom Typ <a 
  href="https://developers.xsolla.com/de/webhooks/operation/payment">Zahlung</a> 
  erfolgreich verarbeitet wurde. Der Webhook enthält Details über das 
  abgeschlossene Abonnement und die Nutzerdaten. Verwenden Sie die Webhook-Daten, 
  um das Abonnement des Nutzers zu verlängern oder die Abonnementparameter zu 
  ändern.
- <a href="/webhooks/operation/refund">Erstattung</a> (`refund`) – wird gesendet, 
  wenn eine Bestellung storniert wird und enthält die Daten der stornierten 
  Zahlung sowie Transaktionsdetails.
- <a href="/webhooks/operation/canceled-subscription/">Gekündigtes Abonnement</a> 
  (`cancel_subscription`) – wird gesendet, wenn ein Webhook vom Typ <a 
  href="/webhooks/operation/refund">Erstattung</a> erfolgreich verarbeitet oder 
  das Abonnement aus einem anderen Grund gekündigt wurde. Der Webhook enthält 
  Informationen über das Abonnement und die Nutzerdaten. Verwenden Sie die 
  Webhook-Daten, um die vom Nutzer abgeschlossenen Abonnements zu kündigen.

# Webhooks im Kundenportal einrichten

## Allgemeine Einstellungen

So aktivieren Sie den Empfang von Webhooks:
1. Navigieren Sie im Kundenportal-Projekt zu <a 
   href="https://publisher.xsolla.com/0/projects/0/edit/webhooks/">Projekteinstellu
   ngen &gt; Webhooks</a>.
2. Geben Sie im Feld <b>Webhook-Server</b> 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.

<div class="notice">
<p><strong>Hinweis:</strong></p>
<p> Für die Datenübertragung wird das HTTPS-Protokoll verwendet; das HTTP-Protokoll wird nicht unterstützt.</p>
</div>

<p></p>

3. 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.
4. Klicken Sie auf <b>Webhooks aktiveren</b>.

![Enable 
webhooks](https://cdn.xsolla.net/developers/current/images/api_docs/enable.png)

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Webhooks können Sie auch über eine beliebige zweckbestimmte Website (z. B. <a href="https://webhook.site/#!/">webhook.site</a>) oder Plattform (z. B. <a href="https://ngrok.com/">ngrok</a>) testen.</p>
</div>

<p></p>

<div class="notice">
    <p><strong>Hinweis</strong></p>
    <p>Sie können Webhooks nicht gleichzeitig an verschiedene URLs senden. Im Kundenportal können Sie jedoch zunächst eine URL zum Testen angeben und diese dann durch die echte URL ersetzen.</p>
</div>

So deaktivieren Sie den Empfang von Webhooks:
1. Navigieren Sie im Kundenportal-Projekt zu <a 
   href="https://publisher.xsolla.com/0/projects/0/edit/webhooks/">Projekteinstellu
   ngen &gt; Webhooks</a>.
2. Klicken Sie auf <b>Webhooks deaktivieren</b>.

## Erweiterte Einstellungen

Für die Webhooks im Abschnitt <a href="/webhooks/overview/#section/Test-
webhooks-in-Publisher-Account/Store">Payments und Store</a> sind erweiterte 
Einstellungen verfügbar. Diese werden automatisch unter dem Block <a 
href="/webhooks/overview/#section/Set-up-webhooks-in-Publisher-Account/General-
settings">Allgemeine Einstellungen</a> angezeigt, nachdem Sie auf die 
Schaltfläche <b>Webhooks abrufen</b> geklickt haben.

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Wenn die erweiterten Einstellungen nicht angezeigt werden, müssen Sie zuerst den Webhook-Empfang in den allgemeinen Einstellungen aktivieren und dann zur Registerkarte <b>Testen &gt; Payments und Store</b> wechseln.</p>
</div>

Hier können Sie den Empfang zusätzlicher Informationen in Webhooks einrichten. 
Dazu müssen Sie die entsprechenden Schalter aktivieren. In jeder 
Berechtigungszeile werden die Webhooks angezeigt, die von der Änderung der 
Einstellungen betroffen sind.

<table>
<thead>
    <tr>
        <th>Schalter</th>
        <th>Beschreibung</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>Infos über das gespeicherte Zahlungskonto anzeigen</td>
        <td>Informationen über die gespeicherte Zahlungsmethode werden in dem benutzerdefinierten Objekt <code>payment_account</code> übermittelt.</td>
    </tr>
    <tr>
        <td>Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden</td>
        <td><p>Informationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.</p><ul><li><code>saved_payment_method</code>:<ul><li><code>0</code> – die gespeicherte Zahlungsmethode wurde nicht verwendet</li><li><code>1</code> – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert</li><li><code>2</code> – die zuvor gespeicherte Zahlungsmethode wird verwendet</li></ul></li><li><code>payment_type</code>:<ul><li><code>1</code> – Einmalzahlung</li><li><code>2</code> – wiederkehrende Zahlung</li></ul></li></ul></td>
    </tr>
    <tr>
        <td>Bestellobjekt dem Webhook hinzufügen</td>
        <td>Die Informationen über die Bestellung werden im <code>order</code>-Objekt des <a href="/webhooks/operation/payment/">Zahlung</a>-Webhooks übermittelt.</td>
    </tr>
    <tr>
        <td>Nur notwendige Nutzerparameter ohne vertrauliche Daten senden</td>
        <td><p>Im Webhook werden nur die folgenden Nutzerinformationen übermittelt:</p><ul><li>ID</li><li>Land</li></ul></td>
    </tr>
    <tr>
        <td>Individuelle Parameter senden</td>
        <td>Informationen über <a href="/api/pay-station/operation/create-token/">individuelle Tokenparameter</a> werden in dem Webhook übermittelt.</td>
    </tr>
    <tr>
        <td>BLZ und Endziffern von Karten anzeigen</td>
        <td><p>Im Webhook werden nur die folgenden Informationen über die Bankkartennummer übermittelt:</p><ul><li>die ersten sechs Ziffern im Parameter <code>card_bin</code></li><li>die letzten vier Ziffern im Parameter <code>card_suffix</code></li></ul></td>
    </tr>
    <tr>
        <td>Kartenmarke anzeigen</td>
        <td>Die Marke der Karte, mit der die Zahlung getätigt wurde. Zum Beispiel: Mastercard oder Visa.</td>
    </tr>
</tbody>
</table>

![Erweiterte 
Einstellungen](https://cdn.xsolla.net/developers/current/images/api_docs/advanced-settings-upd.png)

# Webhooks im Kundenportal testen

Webhooks zu testen, hilft dabei, sicherzustellen, dass das Projekt sowohl bei 
Ihnen als auch aufseiten von Xsolla korrekt eingerichtet ist.

Sind die Webhooks erfolgreich <a href="/webhooks/overview/#section/Set-up-
webhooks-in-Publisher-Account">eingerichtet</a>, wird unterhalb des 
Einrichtungsbereichs ein Bereich zum Testen von Webhooks angezeigt.

![Webhook-
Testbereich](https://cdn.xsolla.net/developers/current/images/api_docs/testing.png)

Der Testbereich im Kundenportal variiert je nach dem, welche Webhook-
Empfangsoption ausgewählt sind.

<b>Beim Empfang kombinierter Webhooks:</b>

<table>
<thead>
    <tr>
        <th>Registerkartenname für Webhook-Tests</th>
        <th>Webhook-Name und ‑Typ</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td><b>Payments und Store</b></td>
        <td>Benutzervalidierung &gt; <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> (<code>user_validation</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Spieldienste &gt; kombinierte Webhooks &gt; <a href="/webhooks/operation/successful-order-payment">Erfolgreiche Bezahlung der Bestellung</a> (<code>order_paid</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Spieldienste &gt; kombinierte Webhooks &gt; <a href="/webhooks/operation/order-cancellation">Stornierung der Bestellung</a> (<code>order_canceled</code>)</td>
    </tr>
    <tr>
        <td><b>Subscriptions</b></td>
        <td>Benutzervalidierung &gt; <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> (<code>user_validation</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Zahlungen &gt; <a href="/webhooks/operation/payment">Zahlung</a> (<code>payment</code>)</td>
    </tr>
</tbody>
</table>


<b>Beim Empfang separater Webhooks:</b>

<table>
<thead>
    <tr>
        <th>Registerkartenname für Webhook-Tests</th>
        <th>Webhook-Name und ‑Typ</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td><b>Store</b></td>
        <td>Spieldienste &gt; separate Webhooks &gt; <a href="/webhooks/operation/successful-order-payment-separate">Erfolgreiche Bezahlung der Bestellung</a> (<code>order_paid</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Spieldienste &gt; separate Webhooks &gt; <a href="/webhooks/operation/order-cancellation-separate">Stornierung der Bestellung</a> (<code>order_canceled</code>)</td>
    </tr>
    <tr>
        <td><b>Payments</b></td>
        <td>Benutzervalidierung &gt; <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> (<code>user_validation</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Zahlungen &gt; <a href="/webhooks/operation/payment">Zahlung</a> (<code>payment</code>)</td>
    </tr>
    <tr>
        <td><b>Subscriptions</b></td>
        <td>Benutzervalidierung &gt; <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> (<code>user_validation</code>)</td>
    </tr>
    <tr>
        <td></td>
        <td>Zahlungen &gt; <a href="/webhooks/operation/payment">Zahlung</a> (<code>payment</code>)</td>
    </tr>
</tbody>
</table>

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Wird im Testbereich eine Fehlermeldung angezeigt, wonach der Test nicht erfolgreich war, sollten Sie in den Einstellungen Ihres <a href="/webhooks/overview/#section/Webhook-listener">Webhook-Listener</a> prüfen, wie dieser auf Webhooks antwortet. Die Gründe für den fehlgeschlagenen Test sind in den Testergebnissen ersichtlich.</p>
<p><b>Beispiel:</b></p>
<p>Sie haben eine spezielle Website (z. B. <a href="https://webhook.site/#!/">webhook.site</a>) zum Testen verwendet.</p>
<p>Im Abschnitt <b>Test: Antwort auf eine ungültige Signatur</b> wird ein Fehler angezeigt.</p>
<p>Das liegt daran, dass Xsolla einen Webhook mit falscher Signatur gesendet hat und nun erwartet, dass Ihr Handler mit dem HTTP-Statuscode <code>4xx</code> und dem Fehlercode <code>INVALID_SIGNATURE</code> antwortet.</p>
<p><a href="https://webhook.site/#!/">webhook.site</a> antwortet allen Webhooks mit dem HTTP-Statuscode <code>200</code>, selbst solchen Webhooks mit ungültiger Signatur. Weil der HTTP-Statuscode <code>4xx</code> nicht wie erwartet empfangen wurde, ist das Testergebnis fehlerhaft.</p>
</div>

![Testfehler](https://cdn.xsolla.net/developers/current/images/api_docs/test-error.png)

Im Folgenden ist der Testvorgang für das Szenario mit kombinierten Webhooks 
beschrieben.

## Payments und Store

Auf der Registerkarte <b>Payments und Store</b> können Sie die folgenden 
Webhooks testen:
- <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> 
  (`user_validation`)
- <a href="/webhooks/operation/successful-order-payment">Erfolgreiche Bezahlung 
  der Bestellung</a> (`order_paid`)
- <a href="/webhooks/operation/order-cancellation">Stornierung der Bestellung</a> 
  (`order_canceled`)

So testen Sie die Webhooks:
1. Wechseln Sie im Webhooks-Testbereich zur Registerkarte <b>Payments und 
   Store</b>.
2. Wählen Sie im Drop-down-Menü einen Artikeltyp aus. Ist der ausgewählte 
   Artikeltyp im Kundenportal nicht eingerichtet, klicken Sie auf:
   * <b>Verknüpfen</b>, sofern das entsprechende Modul noch nicht verknüpft ist,
   * <b>Konfigurieren</b>, sofern das Modul bereits verknüpft, aber die Einrichtung 
     noch nicht abgeschlossen ist. <br/>Durch Klick auf die Schaltfläche werden Sie 
     zum entsprechenden Abschnitt im Kundenportal weitergeleitet. Nachdem Sie den 
     Artikel angelegt haben, sollten Sie zum Webhook-Testbereich zurückkehren und 
     mit dem nächsten Schritt fortfahren.
3. Füllen Sie die Pflichtfelder aus: <ol type="a"> <li>Wählen Sie die SKU des 
   Artikels aus der der Drop-down-Liste aus, und legen Sie die Menge fest. Sie 
   können mehrere Artikel desselben Typs wählen, indem Sie auf <b>+</b> klicken 
   und einen weiteren Artikel in der neuen Zeile hinzufügen.</li> <li><b>Benutzer-
   ID</b> – Zum Testen können Sie eine beliebige Kombination aus Buchstaben und 
   Ziffern angeben.</li> <li><b>Public-User-ID</b> – ID, die dem Nutzer bekannt 
   ist, z. B. E-Mail-Adresse oder Nickname. Dieses Feld wird angezeigt, sofern die 
   Public-User-ID in Ihrem Projekt unter <b>Pay Station &gt; Einstellungen</b> 
   aktiviert ist.</li> <li>Geben Sie einen beliebigen Wert in das Feld <b>Xsolla-
   Bestell-ID</b> ein.</li> <li><b>Xsolla-Rechnungs-ID</b> – Transaktions-ID 
   aufseiten von Xsolla. Zum Testen können Sie eine beliebige Ziffernfolge 
   angeben.</li> <li><b>Rechnungs-ID</b> – Transaktions-ID aufseiten Ihres Spiels. 
   Zum Testen können Sie eine beliebige Kombination aus Buchstaben und Ziffern 
   angeben. Dieser Parameter ist für eine erfolgreiche Zahlung nicht erforderlich. 
   Allerdings können Sie die Transaktions-ID aufseiten Ihres Spiels mit der 
   Transaktions-ID aufseiten von Xsolla verknüpfen, indem Sie den Parameter 
   übermitteln.</li> <li><b>Betrag</b> – Zahlungsbetrag. Zum Testen können Sie 
   eine beliebige Ziffernfolge angeben.</li> <li><b>Währung</b> – Wählen Sie eine 
   Währung aus der Drop-down-Liste aus.</li> </ol>

4. Klicken Sie auf <b>Webhooks testen</b>.


Die Webhooks <a href="/webhooks/operation/user-
validation/">Benutzervalidierung</a>, <a href="/webhooks/operation/successful-
order-payment">Erfolgreiche Bezahlung der Bestellung</a> und <a 
href="/webhooks/operation/order-cancellation">Stornierung der Bestellung</a> 
werden zusammen mit den angegebenen Daten an die festgelegte URL gesendet. Die 
Testergebnisse der einzelnen Webhook-Typen werden unter der Schaltfläche 
<b>Webhooks testen</b> angezeigt.

Wenn in Ihrem Projekt die Public-User-ID aktiviert ist, werden ebenso die 
Ergebnisse einer Benutzerprüfung angezeigt.

Für jeden Webhook müssen Sie die Verarbeitung beider Szenarien, also 
erfolgreich und fehlerbehaftet, konfigurieren.

![Abschnitt zum Testen von 
Zahlungen](https://cdn.xsolla.net/developers/current/images/api_docs/payments-tab.png)

## Subscriptions
Auf der Registerkarte <b>Subscriptions</b> können Sie die folgenden Webhooks 
testen:
- <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> 
  (`user_validation`)
- <a href="/webhooks/operation/payment">Zahlung</a> (`payment`)

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Im Kundenportal können Sie nur die grundlegenden Webhooks vom Typ "Benutzervalidierung" und "Zahlung" testen. Wie Sie andere Webhook-Typen testen, erfahren Sie unter:</p>
<p><ul><li><a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_test_payment">Abonnementabschluss testen</a></li><li><a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_test_renewal">Abonnementverlängerung testen</a></li><li><a href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_test_cancelation">Abonnementkündigung testen</a></li></ul></p>
</div>

<p></p>

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Damit Sie Webhooks testen können, müssen Sie unter <b>Kundenportal &gt; Subscriptions &gt; Abo-Modelle</b> mindestens eine <a href="/doc/subscriptions/integration-guide/set-up-plan/">Abo-Modell erstellt haben</a>.</p>
</div>

So testen Sie die Webhooks: <ol> <li>Wechseln Sie im Testbereich zur 
Registerkarte <b>Subscriptions</b>.</li> <li>Füllen Sie die Pflichtfelder aus: 
<ol type="a"> <li><b>Benutzer-ID</b> – Zum Testen können Sie eine beliebige 
Kombination aus Buchstaben und Ziffern angeben.</li> <li><b>Xsolla-Rechnungs-
ID</b> – Transaktions-ID aufseiten von Xsolla. Zum Testen können Sie eine 
beliebige Ziffernfolge angeben.</li> <li><b>Public- User-ID</b> – ID, die einem 
Nutzer bekannt ist, z. B. E-Mail-Adresse oder Nickname. Dieses Feld wird 
angezeigt, sofern die Public-User-ID in Ihrem Projekt unter Pay Station &gt; 
Einstellungen &gt; Sonstige Einstellungen aktiviert ist.</li> 
<li><b>Währung</b> – Wählen Sie eine Währung aus der Drop-down-Liste aus.</li> 
<li><b>ID des Abo-Modells</b> – Abo-Modell. Wählen Sie ein Abo-Modell aus der 
Drop-down-Liste.</li> <li><b>Abo-Produkt</b> – Wählen Sie ein Produkt aus der 
Drop-down-Liste (optional).</li> <li><b>Betrag</b> – Zahlungsbetrag. Zum Testen 
können Sie eine beliebige Ziffernfolge angeben.</li> <li><b>Rechnungs-ID</b> – 
Transaktions-ID aufseiten Ihres Spiels. Zum Testen können Sie eine beliebige 
Kombination aus Buchstaben und Ziffern angeben. Dieser Parameter ist nicht 
erforderlich, um die Zahlung erfolgreich zu verarbeiten. Allerdings können Sie 
die Transaktions-ID aufseiten Ihres Spiels mit der Transaktions-ID aufseiten 
von Xsolla verknüpfen, indem Sie den Parameter übermitteln.</li> 
<li><b>Probezeitraum</b>. Wenn Sie den <a href="/doc/subscriptions/integration-
guide/get-subscription-
information/#guides_subscriptions_get_subscription_set_up_webhooks_sandbox">Absc
hluss eines Abonnements ohne Probezeitraum</a> oder die <a 
href="/doc/subscriptions/integration-guide/get-subscription-information/#guides_subscriptions_get_subscription_set_up_webhooks_test_renewal"
>Verlängerung eines Abonnements</a> testen möchten, geben Sie den Wert 
<code>0</code> an.</li> </ol> </li> <li>Klicken Sie auf <b>Webhooks 
testen</b>.</li> </ol>

Unter der angegebenen URL erhalten Sie Webhooks mit ausgefüllten Daten. Die 
Testergebnisse jedes Webhooks, sowohl für ein erfolgreiches Szenario als auch 
für ein Fehlerszenario, werden unter der Schaltfläche <b>Webhooks testen</b> 
angezeigt.

<a id="webhook-listener"></a>

# Webhook-Listener

Ein Webhook-Listener ist ein Programmcode, der es ermöglicht, eingehende 
Webhooks unter einer bestimmten URL-Adresse zu empfangen, <a 
href="/webhooks/overview/#section/Webhook-listener/Generation-of-
signature">eine Signatur zu generieren</a> und dem Xsolla-Webhook-Server zu <a 
href="/webhooks/overview/#section/Webhook-listener/Sending-responses-to-
webhook">antworten</a>.

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Sie können die <a href="https://developers.xsolla.com/de/sdk/php/">Pay Station PHP SDK-Bibliothek</a> verwenden, die vorgefertigte Klassen für die Verarbeitung von Webhooks enthält.</p>
</div>

<!-- IMPORTANT! Changing the list of IP addresses should be coordinated with the administrators. Request for Director of Infrastructure and IT approval in the ticket for changing the IP address list. -->

Implementieren Sie anwendungsseitig den Empfang von Webhooks von den folgenden 
IP-Adressen:
- `185.30.20.0/24`
- `185.30.21.0/24`
- `185.30.22.0/24`
- `185.30.23.0/24`
- `34.102.38.178`
- `34.94.43.207`
- `35.236.73.234`
- `34.94.69.44`
- `34.102.22.197`

Wenn Sie das Produkt <a href="/doc/login/">Login</a> integriert haben, müssen 
zusätzlich implementieren, dass Webhooks von den folgenden IP-Adressen 
verarbeitet werden:

- `34.94.0.85`
- `34.94.14.95`
- `34.94.25.33`
- `34.94.115.185`
- `34.94.154.26`
- `34.94.173.132`
- `34.102.48.30`
- `35.235.99.248`
- `35.236.32.131`
- `35.236.35.100`
- `35.236.117.164`

Einschränkungen:
- In der Datenbank Ihrer Anwendung dürfen nicht mehrere erfolgreiche 
  Transaktionen mit derselben ID vorhanden sein.
- Wenn der Webhook-Listener einen Webhook mit einer ID empfängt, die bereits in 
  der Datenbank vorhanden ist, muss das Ergebnis der zuvor verarbeiteten 
  Transaktion zurückgeben werden. Es wird davon abgeraten, dem Nutzer einen 
  gekauften Artikel zweimal zu gewähren und doppelte Datensätze in der Datenbank 
  anzulegen.

## Signatur generieren

Um eine sichere Datenübertragung zu gewährleisten, müssen Sie verifizieren, ob 
der Webhook tatsächlich vom Xsolla-Server gesendet und während der Übertragung 
nicht manipuliert wurde. Generieren Sie dazu Ihre eigene Signatur basierend auf 
der Payload des Anfragerumpfs und vergleichen Sie diese mit der Signatur im 
`authorization`-Header der eingehenden Anfrage. Wenn die Signaturen 
übereinstimmen, ist der Webhook authentisch und kann gefahrlos verarbeitet 
werden.

Verifizierungsablauf:

1. Rufen Sie die Signatur aus dem `authorization`-Header der eingehenden Webhook-
   Anfrage ab. Das Header-Format ist wie folgt: `Signature <signature_value>`.
2. Rufen Sie den Webhook-Anfragerumpf im JSON-Format ab. <div 
   class="notice"><p><strong>Hinweis</strong></p><p>Verwenden Sie die JSON-Payload 
   genau so, wie Sie sie erhalten haben. Die Payload darf nicht geparst oder neu 
   codiert werden, da dies die Formatierung verändert, woraufhin die 
   Signaturüberprüfung fehlschlägt.</p></div><p></p>

3. Generieren Sie Ihre eigene Signatur für den Abgleich: <ol type="a"> 
   <li>Verknüpfen Sie die JSON-Payload mit dem geheimen Schlüssel Ihres Projekts, 
   indem Sie den Schlüssel an das Ende des Strings anhängen.</li> <li>Wenden Sie 
   die kryptografische Hash-Funktion SHA-1 auf den resultierenden String an. Als 
   Ergebnis erhalten Sie einen hexadezimalen String aus Kleinbuchstaben.</li> </ol>
4. Vergleichen Sie die generierte Signatur mit der Signatur im 
   `authorization`-Header. Wenn beide übereinstimmen, ist der Webhook authentisch.

Nachfolgend finden Sie Beispiele für die Implementierung der 
Signaturgenerierung für die folgenden Sprachen: C#, C++, Go, PHP und Node.js.

### Beispielhafter Webhook (HTTP):

```http
POST /your_uri HTTP/1.1
host: your.host
accept: application/json
content-type: application/json
content-length: 165
authorization: Signature 52eac2713985e212351610d008e7e14fae46f902
{
  "notification_type":"user_validation",
  "user":{
      "ip":"127.0.0.1",
      "phone":"18777976552",
      "email":"email@example.com",
      "id":1234567,
      "name":"Xsolla User",
      "country":"US"
  }
}
```

### Beispielhafter Webhook (curl):

```bash
curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'authorization: Signature 52eac2713985e212351610d008e7e14fae46f902' \
-d '{
  "notification_type":
    "user_validation",
    "user":
      {
        "ip": "127.0.0.1",
        "phone": "18777976552",
        "email": "email@example.com",
        "id": 1234567,
        "name": "Xsolla User",
        "country": "US"
      }
    }'
```

### Implementierung der Signaturgenerierung in C# (Allgemeines Beispiel):

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Dieses Code-Beispiel ist kompatibel mit .NET Framework 4.0 und höher sowie mit .NET Core und anderen modernen .NET-Versionen. Die Signaturüberprüfung verwendet einen Vergleich mit konstanter Zeit mithilfe der <code>ConstantTimeEquals</code>-Methode zur Verhinderung von Timing-Angriffen.</p>
</div>

```csharp
using System;
using System.Security.Cryptography;
using System.Text;
public static class XsollaWebhookSignature
{
    public static string ComputeSha1(string jsonBody, string secretKey)
    {
        // Concatenation of the JSON from the request body and the project's secret key
        string dataToSign = jsonBody + secretKey;
        using (SHA1 sha1 = SHA1.Create())
        {
            byte[] hashBytes = sha1.ComputeHash(Encoding.UTF8.GetBytes(dataToSign));
            // Convert hash bytes to lowercase hexadecimal string
            var hexString = new StringBuilder(hashBytes.Length * 2);
            foreach (byte b in hashBytes)
            {
                hexString.Append(b.ToString("x2"));
            }
            return hexString.ToString();
        }
    }
    public static bool VerifySignature(string jsonBody, string secretKey, string receivedSignature)
    {
        string computedSignature = ComputeSha1(jsonBody, secretKey);
        string receivedSignatureLower = receivedSignature.ToLower();
        // Use constant-time comparison to prevent timing attacks
        return ConstantTimeEquals(computedSignature, receivedSignatureLower);
    }
    private static bool ConstantTimeEquals(string a, string b)
    {
        if (a.Length != b.Length)
        {
            return false;
        }
        int result = 0;
        for (int i = 0; i < a.Length; i++)
        {
            result |= a[i] ^ b[i];
        }
        return result == 0;
    }
}
```

### Implementierung der Signaturgenerierung in C# (.NET 5.0 und höher):

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Um die <code>Convert.ToHexString</code>-Methode nutzen zu können, brauchen Sie .NET 5.0 oder höher.<p></p>Über .NET 7.0 oder höher verfügen, können Sie anstelle von <code>ConstantTimeEquals</code> auch die <code>CryptographicOperations.FixedTimeEquals</code>-Methode verwenden.</p>
</div>

```csharp
// For .NET 5.0 and later, you can use the more concise Convert.ToHexString method:
using System;
using System.Security.Cryptography;
using System.Text;
public static class XsollaWebhookSignature
{
    public static string ComputeSha1(string jsonBody, string secretKey)
    {
        string dataToSign = jsonBody + secretKey;
        using var sha1 = SHA1.Create();
        byte[] hashBytes = sha1.ComputeHash(Encoding.UTF8.GetBytes(dataToSign));
        return Convert.ToHexString(hashBytes).ToLower();
    }
    public static bool VerifySignature(string jsonBody, string secretKey, string receivedSignature)
    {
        string computedSignature = ComputeSha1(jsonBody, secretKey);
        string receivedSignatureLower = receivedSignature.ToLower();
        // Use constant-time comparison to prevent timing attacks
        return ConstantTimeEquals(computedSignature, receivedSignatureLower);
    }
    private static bool ConstantTimeEquals(string a, string b)
    {
        if (a.Length != b.Length)
        {
            return false;
        }
        int result = 0;
        for (int i = 0; i < a.Length; i++)
        {
            result |= a[i] ^ b[i];
        }
        return result == 0;
    }
}
```

### Implementierung der Signaturgenerierung in C# (.NET 7.0 und höher):

<div class="note">
<p><strong>Hinweis</strong></p>
<p> Wenn Sie über .NET 7.0 oder höher verfügen, könne Sie die <code>CryptographicOperations.FixedTimeEquals</code>-Methode verwenden.</p>
</div>

```csharp
// For .NET 7.0+, you can use the built-in CryptographicOperations.FixedTimeEquals:
using System.Security.Cryptography;
public static bool VerifySignature(string jsonBody, string secretKey, string receivedSignature)
{
    string computedSignature = ComputeSha1(jsonBody, secretKey);
    byte[] computedBytes = Encoding.UTF8.GetBytes(computedSignature);
    byte[] receivedBytes = Encoding.UTF8.GetBytes(receivedSignature.ToLower());
    return CryptographicOperations.FixedTimeEquals(computedBytes, receivedBytes);
}
```

### Implementierung der Signaturgenerierung in C++ (Beispiel):

```c++
#include <string>
#include <sstream>
#include <iomanip>
#include <openssl/sha.h>
class XsollaWebhookSignature {
public:
    static std::string computeSha1(const std::string& jsonBody, const std::string& secretKey) {
        // Concatenation of the JSON from the request body and the project's secret key
        std::string dataToSign = jsonBody + secretKey;
        unsigned char digest[SHA_DIGEST_LENGTH];
        // Create SHA1 hash
        SHA1(reinterpret_cast<const unsigned char*>(dataToSign.c_str()),
             dataToSign.length(), digest);
        // Convert to lowercase hexadecimal string
        std::ostringstream hexStream;
        hexStream << std::hex << std::setfill('0');
        for (int i = 0; i < SHA_DIGEST_LENGTH; ++i) {
            hexStream << std::setw(2) << static_cast<unsigned int>(digest[i]);
        }
        return hexStream.str();
    }
    static bool verifySignature(const std::string& jsonBody, const std::string& secretKey, const std::string& receivedSignature) {
        std::string computedSignature = computeSha1(jsonBody, secretKey);
        // Timing-safe comparison
        if (computedSignature.length() != receivedSignature.length()) {
            return false;
        }
        volatile unsigned char result = 0;
        for (size_t i = 0; i < computedSignature.length(); ++i) {
            result |= (computedSignature[i] ^ receivedSignature[i]);
        }
        return result == 0;
    }
};
```

### Implementierung der Signaturgenerierung in Go (Beispiel):

```go
package main
import (
	"crypto/sha1"
    "crypto/subtle"
	"encoding/hex"
	"strings"
)
type XsollaWebhookSignature struct{}
func (x *XsollaWebhookSignature) ComputeSha1(jsonBody, secretKey string) string {
	// Concatenation of the JSON from the request body and the project's secret key
	dataToSign := jsonBody + secretKey
	// Create SHA1 hash
	h := sha1.New()
	h.Write([]byte(dataToSign))
	signature := h.Sum(nil)
	// Convert to lowercase hexadecimal string
	return strings.ToLower(hex.EncodeToString(signature))
}
func (x *XsollaWebhookSignature) VerifySignature(jsonBody, secretKey, receivedSignature string) bool {
	computedSignature := x.ComputeSha1(jsonBody, secretKey)
	receivedSignatureLower := strings.ToLower(receivedSignature)
	// Use constant time comparison to prevent timing attacks
	return subtle.ConstantTimeCompare([]byte(computedSignature), []byte(receivedSignatureLower)) == 1
}
```

### Implementierung der Signaturgenerierung in PHP (Beispiel):

```php
<?php
class XsollaWebhookSignature
{
    /**
     * Compute SHA1 signature from webhook JSON body and secret key
     *
     * @param string $jsonBody The raw JSON body from webhook
     * @param string $secretKey The project's secret key
     * @return string The lowercase SHA1 signature
     */
    public static function computeSha1(string $jsonBody, string $secretKey): string
    {
        // Concatenation of the JSON from the request body and the project's secret key
        $dataToSign = $jsonBody . $secretKey;
        // Generate SHA1 signature
        $signature = sha1($dataToSign);
        return strtolower($signature);
    }
    /**
     * Verify webhook signature using timing-safe comparison
     *
     * @param string $jsonBody The raw JSON body from webhook
     * @param string $secretKey The project's secret key  
     * @param string $receivedSignature The signature from authorization header
     * @return bool True if signature is valid, false otherwise
     */
    public static function verifySignature(string $jsonBody, string $secretKey, string $receivedSignature): bool
    {
        $computedSignature = self::computeSha1($jsonBody, $secretKey);
        // Use hash_equals for timing-safe comparison
        return hash_equals($computedSignature, strtolower($receivedSignature));
    }
}
?>
```

### Implementierung der Signaturgenerierung in Node.js (Beispiel):

```js
const crypto = require('crypto');
class XsollaWebhookSignature {
    // IMPORTANT: jsonBody must be the raw JSON string exactly as received from Xsolla
    static computeSha1(jsonBody, secretKey) {
        // Concatenation of the JSON from the request body and the project's secret key
        const dataToSign = jsonBody + secretKey;
        // Create SHA1 hash
        const hash = crypto.createHash('sha1');
        hash.update(dataToSign, 'utf8');
        // Convert to lowercase hexadecimal string
        return hash.digest('hex').toLowerCase();
    }
    static verifySignature(jsonBody, secretKey, receivedSignature) {
        const computedSignature = this.computeSha1(jsonBody, secretKey);
        const cleanReceivedSignature = receivedSignature.toLowerCase();
        // Check if signatures have the same length before using timingSafeEqual
        if (computedSignature.length !== cleanReceivedSignature.length) {
            return false;
        }
        try {
            return crypto.timingSafeEqual(
                Buffer.from(computedSignature, 'hex'),
                Buffer.from(cleanReceivedSignature, 'hex')
            );
        } catch (error) {
            // Return false if there's any error (e.g., invalid hex characters)
            return false;
        }
    }
}
```

## Dem Webhook antworten

Ihr Server muss wie folgt antworten, um den Empfang eines Webhooks zu 
bestätigen:
* mit dem HTTP-Statuscode 200, 201 oder 204 ohne Nachrichtenrumpf im Falle einer 
  positiven Antwort
* mit dem HTTP-Statuscode 400 samt <a 
  href="/webhooks/overview/#section/Fehler">Problembeschreibung</a>, sofern der 
  angegebene Benutzer nicht gefunden oder eine ungültige Signatur übermittelt 
  wurde. Ihr Webhook-Handler kann ebenso mit dem HTTP-Stautscode 5xx antworten, 
  wenn Ihr Server vorübergehend Probleme hat.

Wenn der Xsolla-Server keine Antwort auf die Webhooks <a 
href="/webhooks/operation/successful-order-payment">Erfolgreiche Bezahlung der 
Bestellung</a> und <a href="/webhooks/operation/order-cancellation">Stornierung 
der Bestellung</a> empfangen hat oder aber eine Antwort mit dem HTTP-Statuscode 
5xx, werden die Webhooks gemäß dem folgenden Zeitplan erneut gesendet:
* zwei Versuche im Abstand von 5 Minuten
* sieben Versuche im Abstand von jeweils 15 Minuten
* zehn Versuche im Abstand von jeweils 60 Minuten

Innerhalb von 12 Stunden nach dem ersten Versuch werden maximal 20 Versuche 
unternommen, Webhooks zu senden.

Die Logik für das erneute Senden der Webhooks <a 
href="/webhooks/operation/payment">Zahlung</a> und <a 
href="/webhooks/operation/refund">Erstattung</a> ist auf der jeweiligen Webhook-
Seite beschrieben.

<div class="notice">
<p><strong>Hinweis</strong></p>
<p>Die Zahlung wird dem Nutzer auch dann erstattet, wenn alle folgenden Bedingungen erfüllt sind:<ul><li>Xsolla hat die Erstattung veranlasst.</li><li>Als Antwort auf einen Webhook wurde ein Statuscode <code>4xx</code> zurückgegeben, oder es wurde nach allen weiteren Zustellversuchen keine Antwort empfangen, oder es wurde der Statuscode <code>5xx</code> zurückgegeben.</li></ul></p>
</div>

Wenn der Xsolla-Server keine Antwort auf den Webhook <a 
href="/webhooks/operation/user-validation/">Benutzervalidierung</a> empfangen 
hat oder aber eine Antwort mit dem HTTP-Statuscode 400 oder 5xx, wird der 
Webhook <a href="/webhooks/operation/user-validation/">Benutzervalidierung</a> 
nicht erneut gesendet. Stattdessen wird dem Nutzer eine Fehlermeldung angezeigt 
und die Webhooks <a href="/webhooks/operation/payment">Zahlung</a> und <a 
href="/webhooks/operation/successful-order-payment">Erfolgreiche Bezahlung der 
Bestellung</a> werden nicht gesendet.

# Fehler

Fehlercodes für den HTTP-Code 400:

<table>
<thead>
    <tr>
        <th>Code</th>
        <th>Nachricht</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td>INVALID_USER</td>
        <td>Ungültiger Benutzer</td>
    </tr>
    <tr>
        <td>INVALID_PARAMETER</td>
        <td>Ungültiger Parameter</td>
    </tr>
    <tr>
        <td>INVALID_SIGNATURE</td>
        <td>Unzulässige Signatur</td>
    </tr>
    <tr>
        <td>INCORRECT_AMOUNT</td>
        <td>Ungültiger Betrag</td>
    </tr>
    <tr>
        <td>INCORRECT_INVOICE</td>
        <td>Ungültige Rechnung</td>
    </tr>
</tbody>
</table>

```
HTTP/1.1 400 Bad Request
{
    "error":{
        "code":"INVALID_USER",
        "message":"Invalid user"
    }
}
```

# Liste der Webhooks

<div class="note">
<p><strong>Hinweis</strong></p>
<p>Der Benachrichtigungstyp wird im Parameter <code>notification_type</code> gesendet.</p>
</div>

<table>
<thead>
    <tr>
        <th>Webhook</th>
        <th>Benachrichtigungstyp</th>
        <th>Beschreibung</th>
    </tr>
</thead>
<tbody>
    <tr>
        <td><a href="/webhooks/operation/user-validation/">Benutzervalidierung</a></td>
        <td><code>user_validation</code></td>
        <td>Wird versendet, um zu prüfen, ob ein Benutzer im Spiel existiert.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/user-search/">Benutzersuche</a></td>
        <td><code>user_search</code></td>
        <td>Wird versendet, um Benutzerinformationen anhand der öffentlichen Benutzer-ID abzurufen.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/payment/">Zahlung</a></td>
        <td><code>payment</code></td>
        <td>Wird versendet, wenn ein Benutzer eine Zahlung abschließt.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/refund/">Erstattung</a></td>
        <td><code>refund</code></td>
        <td>Wird versendet, falls eine Zahlung aus einem beliebigen Grund storniert werden muss.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/partial-refund/">Teilerstattung</a></td>
        <td><code>partial_refund</code></td>
        <td>Wird versendet, falls eine Zahlung aus einem beliebigen Grund teilweise storniert werden muss.</td>
    </tr>
    <tr>
        <td><a href="/webhooks/operation/payment-declined/">Abgelehnte Zahlung</a></td>
        <td><code>ps_declined</code></td>
        <td>Wird versendet, wenn eine Zahlung vom Zahlungssystem abgelehnt wird.</td>
    </tr>
    <tr>
        <td><a href="https://developers.xsolla.com/de/webhooks/operation/afs-rejected-transaction/">Abgelehnte Transaktion (AFS)</a></td>
        <td><code>afs_reject</code></td>
        <td>Wird versendet, wenn eine Transaktion während einer AFS-Prüfung abgelehnt wird.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/afs-rejected-blocklist/">Aktualisierte AFS-Blockliste</a></td>
      <td><code>afs_black_list</code></td>
      <td>Wird bei Aktualisierung der AFS-Blockliste versendet.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/created-subscription/">Abgeschlossenes Abonnement</a></td>
      <td><code>create_subscription</code></td>
      <td>Wird versendet, wenn ein Benutzer ein Abonnement abschließt.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/updated-subscription/">Aktualisiertes Abonnement</a></td>
      <td><code>update_subscription</code></td>
      <td>Wird versendet, wenn ein Abonnement erneuert oder geändert wird.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/canceled-subscription/">Storniertes Abonnement</a></td>
      <td><code>cancel_subscription</code></td>
      <td>Wird versendet, wenn ein Abonnement gekündigt wird.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/nonrenewing-subscription/">Automatisch endendes Abonnement</a></td>
      <td><code>non_renewal_subscription</code></td>
      <td>Wird versendet, wenn der Status auf "Automatisch endend" gesetzt wird.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/add-payment-account/">Zahlungskonto hinzufügen</a></td>
      <td><code>payment_account_add</code></td>
      <td>Wird versendet, wenn ein Benutzer ein Zahlungskonto hinzufügt oder speichert.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/remove-payment-account/">Zahlungskonto entfernen</a></td>
      <td><code>payment_account_remove</code></td>
      <td>Wird versendet, wenn ein Benutzer das Zahlungskonto aus den gespeicherten Konten entfernt.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/user-validation-in-webshop">Benutzervalidierung im Web Shop</a></td>
      <td><code>-</code></td>
      <td>Wird von einer Web Shop-Seite gesendet, um zu prüfen, ob ein Benutzer im Spiel vorhanden ist.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/personalized-partner-catalog">Katalogpersonalisierung aufseiten des Partners</a></td>
      <td><code>partner_side_catalog</code></td>
      <td>Wird gesendet, wenn ein Benutzer mit dem Shop interagiert.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/successful-order-payment">Erfolgreiche Bezahlung der Bestellung</a></td>
      <td><code>order_paid</code></td>
      <td>Wird gesendet, wenn eine Bestellung bezahlt wurde.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/order-cancellation">Stornierung der Bestellung</a></td>
      <td><code>order_canceled</code></td>
      <td>Wird gesendet, wenn eine Bestellung storniert wird.</td>
    </tr>
    <tr>
      <td><a href="https://developers.xsolla.com/de/webhooks/operation/dispute">Streitfall</a></td>
      <td><code>dispute</code></td>
      <td>Wird gesendet, wenn ein neuer Streiftall eröffnet wird.</td>
    </tr>
</tbody>
</table>


Version: 1.0

## Servers

```
https://api.xsolla.com/merchant/v2
```

## Download OpenAPI description

[Webhooks](https://developers.xsolla.com/_bundle/@l10n/de/webhooks/index.yaml)

## Benutzervalidierung

### Benutzersuche

 - [POST user-search](https://developers.xsolla.com/de/webhooks/user-validation/user-search.md): Public User ID ist ein Parameter, der den Benutzer eindeutig identifiziert und ihm bekannt ist, im Gegensatz zur User ID (Public User ID kann eine E-Mail-Adresse, ein Anzeigename usw. sein). Xsolla sendet einen Webhook vom Typ user_search, wenn ein Kauf außerhalb des Spieleshops getätigt wird (z. B. an einem Automaten).

### Benutzervalidierung

 - [POST user-validation](https://developers.xsolla.com/de/webhooks/user-validation/user-validation.md): Xsolla sendet einen Webhook vom Typ user_validation an die Webhook-URL, um zu 
überprüfen, ob ein Benutzer im Spiel registriert ist. Die Anfrage wird im 
Rahmen des Bezahlvorgangs mehrfach gesendet:

* wenn ein Benutzer eine Zahlungsmethode im Zahlungsportal auswählt
* wenn ein Benutzer Daten in die Zahlungsmaske eingibt, z. B. Bankkartendaten 
  oder die Postleitzahl bei Zahlung über PayPal
* wenn ein Benutzer auf Jetzt bezahlen klickt, um mit der Zahlung fortzufahren
* wenn der Bezahlvorgang abgeschlossen ist und der Transaktionsstatus sich in 
  done ändert

Die Anfrage wird beim Bezahlen gesendet, ganz gleich, welche Zahlungsmethode 
zum Einsatz kommt.

Wenn Sie die Webhook-URL im Kundenportal speichern, können Sie Berechtigungen 
erteilen, detaillierte Informationen in Webhooks zu empfangen. Aktivieren Sie 
dazu im Kundenportal unter Projekteins
tellungen &gt; Webhooks &gt; Erweiterte Einstellungen die entsprechenden 
Schalter.


Hinweis
Wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter unter Projekteinstellungen &gt; Webhooks &gt; Testen &gt; Payments &gt; Erweiterte Einstellungen.




    
        Schalter
        Beschreibung
    


    
        Nur notwendige Nutzerparameter ohne vertrauliche Daten senden
        Im Webhook werden nur die folgenden Nutzerinformationen übermittelt:IDLand
    
    
        Individuelle Parameter senden
        Informationen über individuelle Tokenparameter werden in dem Webhook übermittelt.

### Benutzervalidierung im Web Shop

 - [POST user-validation-in-webshop](https://developers.xsolla.com/de/webhooks/user-validation/user-validation-in-webshop.md): Xsolla sendet einen Webhook von einer Webshop-Seite, um zu prüfen, ob ein Benutzer im Spiel vorhanden ist. Der Webhook wird von der folgenden IP-Adresse gesendet: 34.102.38.178.
 Hinweis
Der Webhook dient lediglich der Benutzervalidierung im Webshop. Wie man Webhooks im Site Builder konfiguriert, erfahren Sie in dieser Anleitung.

## Payments

### Zahlungskonto hinzufügen

 - [POST add-payment-account](https://developers.xsolla.com/de/webhooks/payments/add-payment-account.md): Xsolla sendet eine Webhook vom Typ payment_account_add an die Webhook-URL, wenn ein Benutzer bei einem Ingame-Kauf ein Zahlungskonto hinzufügt oder speichert. Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie diesen Webhook erhalten möchten.

### Teilerstattung

 - [POST partial-refund](https://developers.xsolla.com/de/webhooks/payments/partial-refund.md): Wird ein Betrag teilweise erstattet, sendet Xsolla die Details der stornierten 
Transaktion in einem Webhook vom Typ partial_refund an die Webhook-URL. 
Weitere Informationen zu Teilerstattungen finden Sie in dieser Anleitung.

Wenn Sie die Webhook-URL im Kundenportal speichern, können Sie Berechtigungen 
erteilen, detaillierte Informationen in Webhooks zu empfangen. Aktivieren Sie 
dazu im Kundenportal unter Projekteins
tellungen &gt; Webhooks &gt; Erweiterte Einstellungen den folgenden 
Schalter.


Hinweis
Wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter unter Projekteinstellungen &gt; Webhooks &gt; Testen &gt; Payments &gt; Erweiterte Einstellungen.




    
        Schalter
        Beschreibung
    


    
        Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden
        Informationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.saved_payment_method:0 – die gespeicherte Zahlungsmethode wurde nicht verwendet1 – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert2 – die zuvor gespeicherte Zahlungsmethode wird verwendetpayment_type:1 – Einmalzahlung2 – wiederkehrende Zahlung
    



Codes zur Rückerstattung:


    
    
        Code
        Grund
        Beschreibung
    
    
    
    
        1
        Cancellation by the user request / the game request
        Aus dem Kundenportal heraus eingeleitete Stornierung.
    
    
        3
        Integration error
        Integrationsprobleme zwischen Xsolla und dem Spiel.Empfehlung: Benutzer nicht auf Sperrliste setzen.
    
    
        5
        Test payment
        Testweise getätigte Transaktion gefolgt von Stornierung.Empfehlung: Benutzer nicht auf Sperrliste setzen.
    
    
        7
        Fraud notification from PS
        Zahlung wurde vom Zahlungssystem abgelehnt. Potenzieller Betrug durch Zahlungssystem entdeckt. Empfehlung: Benutzer auf Sperrliste setzen.
    
    
        9
        Cancellation by the user request
        Der Benutzer war aus irgendeinem Grund nicht zufrieden mit dem Spiel oder dem Einkauf.Empfehlung: Benutzer nicht auf Sperrliste setzen.
    
    
        10
        Cancellation by the game request
        Das Spiel hat die Stornierung angefordert.Empfehlung: Benutzer nicht auf Sperrliste setzen.

### Zahlung

 - [POST payment](https://developers.xsolla.com/de/webhooks/payments/payment.md): Wenn ein Nutzer eine Zahlung abschließt, sendet Xsolla die Zahlungsdetails in 
einem Webhook vom Typ payment an die Webhook-URL.

Die erwarteten Antwortcodes sind im Abschnitt Responses beschrieben, Sie 
können jedoch auch andere Antwortcodes verwenden:


    
    
        Antwortcode
        Beschreibung
    
    
    
    
        200, 201, 204
        Eine erfolgreiche Antwort.
    
    
        4xx
        Ein Fehler ist aufgetreten. Beispielsweise wurde der angegebene Nutzer nicht gefunden oder eine ungültige Signatur wurde übermittelt.
    
    
        5xx
        Ein temporärer Serverfehler. Bei einer solchen Antwort versucht Xsolla automatisch, den Webhook erneut zu senden. Dabei verlängert sich das Intervall zwischen den Versuchen schrittweise, bis Ihr Listener den Empfang bestätigt. Es werden maximal 12 Versuche innerhalb eines Zeitraums von 48 Stunden unternommen.
    
    


Wenn Sie die Webhook-URL im Kundenporta
l speichern, können Sie auch den Empfang zusätzlicher Informationen in 
Webhooks einrichten.


Hinweis
Wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter in Ihre Projekt unter Einstellungen &gt; Webhooks &gt; Testen &gt; Payments &gt; Erweiterte Einstellungen.




    
        Schalter
        Beschreibung
    


    
        Infos über das gespeicherte Zahlungskonto anzeigen
        Informationen über die gespeicherte Zahlungsmethode werden in dem benutzerdefinierten Objekt payment_account übermittelt.
    
    
        Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden
        Informationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.saved_payment_method:0 – die gespeicherte Zahlungsmethode wurde nicht verwendet1 – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert2 – die zuvor gespeicherte Zahlungsmethode wird verwendetpayment_type:1 – Einmalzahlung2 – wiederkehrende Zahlung
    
    
        Bestellobjekt dem Webhook hinzufügen
        Die Informationen über die Bestellung werden im order-Objekt des Zahlung-Webhooks übermittelt.
    
    
        Nur notwendige Nutzerparameter ohne vertrauliche Daten senden
        Im Webhook werden nur die folgenden Nutzerinformationen übermittelt:IDLand
    
    
        BLZ und Endziffern von Karten anzeigen
        Im Webhook werden nur die folgenden Informationen über die Bankkartennummer übermittelt:die ersten sechs Ziffern im Parameter card_bindie letzten vier Ziffern im Parameter card_suffix
    
    
        Kartenmarke anzeigen
        Die Marke der Karte, mit der die Zahlung getätigt wurde. Zum Beispiel: Mastercard oder Visa.
    




Hinweis
Die in einem Webhook versendeten Felder hängen von Folgendem ab:den erweiterten Einstellungen im Kundenportalden bei Xsolla konfigurierten benutzerdefinierten EinstellungenBei Fragen wenden Sie sich bitte an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.

### Abgelehnte Zahlung

 - [POST payment-declined](https://developers.xsolla.com/de/webhooks/payments/payment-declined.md): Wenn eine Transaktion von einem Zahlungssystem abgelehnt wird, sendet Xsolla 
die Transaktionsdetails in einem Webhook vom Typ ps_declined an die von Ihnen 
festgelegte Webhook-URL. Der Webhook wird während der Autorisierung- oder 
Zahlungsabwicklung gesendet. In diesem Fall wird der Webhook 
payment\ order_paid nicht gesendet.

Typische Gründe für von Zahlungssystemen abgelehnte Zahlungen:

* Die Kartenautorisierung ist fehlgeschlagen (z. B. konnte das Zahlungssystem den 
  Autorisierungsvorgang aufgrund eines technischen Fehlers oder einer 
  ausbleibenden Antwort der Bank nicht abschließen) oder wurde abgelehnt (z. B. 
  hat die Bank geantwortet, die Transaktion jedoch aufgrund unzureichender 
  Deckung oder ungültiger Kartendaten abgelehnt).
* Die "3-D Secure"-Prüfung ist fehlgeschlagen, wurde nicht abgeschlossen oder es 
  kam zu einem Timeout, weil der Nutzer nicht rechtzeitig bestätigt hat.
* Der Zahlungsabwickler oder die abrechnende Bank (Acquirer) ist vorübergehend 
  nicht verfügbar oder antwortet aufgrund eines nicht behebbaren Fehlers (z. B. 
  einem geschlossenen Konto oder einer ungültigen Kartennummer) mit einer 
  endgültigen Ablehnung. Ein erneuter Versuch ohne Behebung des zugrunde 
  liegenden Problems führt nicht zu einer erfolgreichen Transaktion.

Nicht zu verwechseln mit:

* Ablehnung durch Betrugsbekämpfungssysteme; diese werden über den Webhook 
  afs_reject gemeldet.
* Erstattungen oder Teilerstattungen nach einer erfolgreichen Zahlung; diese 
  werden über die Webhooks 
  refund und 
  partial_refund gemeldet.


Hinweis
 Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie den Webhook ps_declined erhalten möchten.

### Erstattung

 - [POST refund](https://developers.xsolla.com/de/webhooks/payments/refund.md): Wenn eine Zahlung storniert wird, sendet Xsolla die Details der stornierten 
Transaktion in einem Webhook vom Typ refund an die Webhook-URL.

Ob und wie weitere Zustellversuche unternommen werden, hängt davon ab, wer die 
Erstattung veranlasst hat:
* Wenn Sie die Erstattung veranlasst haben, wird der Webhook nicht erneut 
  gesendet. Die Zahlung wird dem Nutzer unabhängig von der Antwort auf einen 
  Webhook erstattet.
* Wenn die Erstattung von einem Dritten veranlasst wurde (beispielsweise einem 
  Zahlungssystem oder dem Xsolla-Kundensupport) und als Antwort auf einen Webhook 
  der Statuscode "5xx" zurückgegeben wurde, wird der Webhook in immer längeren 
  Intervallen erneut gesendet. Innerhalb von 48 Stunden nach dem ersten Versuch 
  werden maximal 12 weitere Zustellversuche unternommen.

Detaillierte Informationen zum Erstattungsvorgang finden Sie in der 
entsprechenden Anleitung.


Hinweis
Die Zahlung wird dem Nutzer auch dann erstattet, wenn alle folgenden Bedingungen erfüllt sind:Xsolla hat die Erstattung veranlasst.Als Antwort auf einen Webhook wurde ein Statuscode 4xx zurückgegeben, oder es wurde nach allen weiteren Zustellversuchen keine Antwort empfangen, oder es wurde der Statuscode 5xx zurückgegeben.


Wenn Sie die Webhook-URL im Kundenporta
l speichern, können Sie auch den Empfang zusätzlicher Informationen in 
Webhooks einrichten.


Hinweis
Wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter in Ihre Projekt unter Einstellungen &gt; Webhooks &gt; Testen &gt; Payments &gt; Erweiterte Einstellungen.




    
        Schalter
        Beschreibung
    


    
        Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden
        Informationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.saved_payment_method:0 – die gespeicherte Zahlungsmethode wurde nicht verwendet1 – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert2 – die zuvor gespeicherte Zahlungsmethode wird verwendetpayment_type:1 – Einmalzahlung2 – wiederkehrende Zahlung
    



Codes zur Rückerstattung:


    
    
        Code
        Grund
        Beschreibung
    
    
    
    
        1
        Cancellation by the user request / the game request
        Aus dem Kundenportal heraus eingeleitete Stornierung.
    
    
        2
        Chargeback
        Rückbuchung der Transaktion angefordert.
    
    
        3
        Integration error
        Integrationsprobleme zwischen Xsolla und dem Spiel.Empfehlung: Benutzer nicht auf Sperrliste setzen.
    
    
        4
        Potential fraud
        Betrugsverdacht.Empfehlung: Benutzer auf Sperrliste setzen.
    
    
        5
        Test payment
        Testweise getätigte Transaktion gefolgt von Stornierung.Empfehlung: Benutzer nicht auf Sperrliste setzen.
    
    
        6
        User invoice expired
        Rechnung überfällig (wird bei Postpaid-Zahlungsweise genutzt).
    
    
        7
        Fraud notification from PS
        Zahlung wurde vom Zahlungssystem abgelehnt. Potenzieller Betrug durch Zahlungssystem entdeckt. Empfehlung: Benutzer auf Sperrliste setzen.
    
    
        8
        Cancellation by the PS request
        Zahlungssystem hat Stornierung angefordert.Empfehlung: Benutzer nicht auf Sperrliste setzen.
    
    
        9
        Cancellation by the user request
        Der Benutzer war aus irgendeinem Grund nicht zufrieden mit dem Spiel oder dem Einkauf.Empfehlung: Benutzer nicht auf Sperrliste setzen.
    
    
        10
        Cancellation by the game request
        Das Spiel hat die Stornierung angefordert.Empfehlung: Benutzer nicht auf Sperrliste setzen.
    
    
        11
        Account holder called to report fraud
        Der Kontoinhaber gibt an, dass die Transaktion nicht von ihm getätigt wurde.
    
    
        12
        Friendly fraud
        Es wurde ein "Friendly Fraud" gemeldet.
    
    
        13
        Duplicate
        Duplizierte Transaktion für dieselbe Rechnung.

### Zahlungskonto entfernen

 - [POST remove-payment-account](https://developers.xsolla.com/de/webhooks/payments/remove-payment-account.md): Wenn ein Benutzer ein Zahlungskonto aus den gespeicherten Konten entfernt, sendet Xsolla einen Webhook vom Typ payment_account_remove an die Webhook-URL. Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie diesen Webhook erhalten möchten.

## Kombinierte Webhooks

### Stornierung der Bestellung (mit Zahlungs- und Transaktionsdetails)

 - [POST order-cancellation](https://developers.xsolla.com/de/webhooks/combined-webhooks/order-cancellation.md): Xsolla sendet den Webhook order_canceled an die angegebene URL, 
wenn die Zahlung vom Nutzer, Partner oder automatisch storniert wurde. Der 
Webhook enthält Informationen über zurückgesandte Artikel, Zahlungsdaten und 
Details zur stornierten Bestellung.

Der Webhook wird nicht gesendet, wenn die Zahlung nicht erfolgreich war, zum 
Beispiel:
* das Zahlungsportal geöffnet wurde, aber der Nutzer die Bestellung nicht bezahlt 
  hat
* das Zahlungsportal geöffnet wurde, aber während der Zahlung Fehler auftraten

Die empfohlene Verarbeitungszeit für Webhooks beträgt maximal drei Sekunden.

### Erfolgreiche Bezahlung der Bestellung (mit Zahlungs- und Transaktionsdetails)

 - [POST successful-order-payment](https://developers.xsolla.com/de/webhooks/combined-webhooks/successful-order-payment.md): Xsolla sendet den Webhook order_paid an die angegebene URL, wenn 
der Nutzer die Bestellung erfolgreich bezahlt hat.

Der Webhook order_paid enthält Informationen zu den gekauften 
Artikeln, Zahlungsdaten und Transaktionsdetails.

Der Webhook order_paid wird nicht gesendet, wenn die Zahlung nicht 
erfolgreich war, zum Beispiel:
* die Zahlungsmaske geöffnet wurde, aber der Benutzer die Bestellung nicht 
  bezahlt hat
* die Zahlungsmaske geöffnet wurde, aber während der Zahlung Fehler auftraten

Es wird empfohlen, den Webhook order_paid in weniger als drei 
Sekunden zu verarbeiten.


Hinweis
Die in einem Webhook versendeten Felder hängen von den folgenden Einstellungen ab:den im Kundenportal unter Projekteinstellungen &gt; Webhooks &gt; Erweiterte Einstellungen konfigurierten Einstellungenden bei Xsolla konfigurierten EinstellungenBei Fragen wenden Sie sich bitte an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.


Die erwarteten Antworten sind im Abschnitt Antworten beschrieben. Sie 
können andere Antwortcodes verwenden. Abhängig vom Antwortcode und je nachdem, 
ob die automatische Zahlungserstattung aktiviert ist oder nicht, sieht die 
Webhook-Verarbeitungslogik aufseiten von Xsolla wie folgt aus:


    
    
        Antwortcode
        Automatische Zahlungserstattung ist deaktiviert (standardmäßig)
        Automatische Zahlungserstattung ist aktiviert
    
    
    
    
        400, 401, 402, 403, 404, 409, 422, 415
        Keine Aktionen
        Benutzer erhält automatische eine Erstattung
    
    
        200, 201, 204
        Keine Aktionen
        Keine Aktionen
    
    
        Anderer Code oder keine Antwort auf Webhook
        Mehrere Webhooks werden innerhalb eines bestimmten Zeitintervalls gesendet: Zwei Versuche im Abstand von 5 Minuten, sieben Versuche im Abstand von jeweils 15 Minuten, zehn Versuche im Abstand von jeweils 60 Minuten.
        Mehrere Webhooks werden innerhalb eines bestimmten Zeitintervalls gesendet: Zwei Versuche im Abstand von 5 Minuten, sieben Versuche im Abstand von jeweils 15 Minuten, zehn Versuche im Abstand von jeweils 60 Minuten. Wurden alle Webhooks gesendet, ohne eine erfolgreiche Antwort erhalten zu haben, wird dem Benutzer automatisch eine Erstattung ausgestellt.
    
    


Wenden Sie sich an Ihre Customer Success Manager oder senden Sie eine E-Mail an 
csm@xsolla.com, um die automatische Erstattungsfunktion zu verknüpfen.

## Separate Webhooks

### Stornierung der Bestellung (ohne Zahlungs- und Transaktionsdetails)

 - [POST order-cancellation-separate](https://developers.xsolla.com/de/webhooks/separate-webhooks/order-cancellation-separate.md): Xsolla sendet den Webhook order_canceled an die angegebene URL, 
wenn die Zahlung vom Nutzer, Partner oder automatisch storniert wurde. Der 
Webhook enthält Informationen über zurückgesandte Artikel und Details zur 
stornierten Bestellung.

Der Webhook wird nicht gesendet, wenn die Zahlung nicht erfolgreich war, zum 
Beispiel:
* das Zahlungsportal geöffnet wurde, aber der Nutzer die Bestellung nicht bezahlt 
  hat
* das Zahlungsportal geöffnet wurde, aber während der Zahlung Fehler auftraten

Die empfohlene Verarbeitungszeit für Webhooks beträgt maximal drei Sekunden.

### Erfolgreiche Bezahlung der Bestellung (ohne Zahlungs- und Transaktionsdetails)

 - [POST successful-order-payment-separate](https://developers.xsolla.com/de/webhooks/separate-webhooks/successful-order-payment-separate.md): Xsolla sendet den Webhook order_paid an die angegebene URL, wenn 
die folgenden Bedingungen erfüllt sind:
1. Der Benutzer hat die Bestellung erfolgreich bezahlt.
2. Xsolla hat eine Antwort über die erfolgreiche Verarbeitung des Webhooks 
   Zahlung erhalten.

Der Webhook order_paid enthält Informationen zu den gekauften 
Artikeln und Transaktionsdetails.

Der Webhook order_paid wird nicht gesendet, wenn:
* die Zahlung nicht erfolgreich war, zum Beispiel:
  * die Zahlungsmaske geöffnet wurde, aber der Benutzer die Bestellung nicht 
    bezahlt hat
  * die Zahlungsmaske geöffnet wurde, aber während der Zahlung Fehler auftraten
* die Antwort über die erfolgreiche Verarbeitung des Webhooks 
  Zahlung nicht eingegangen ist.

Es wird empfohlen, den Webhook order_paid in weniger als drei 
Sekunden zu verarbeiten.

Die erwarteten Antworten sind im Abschnitt Antworten beschrieben. Sie 
können andere Antwortcodes verwenden. Abhängig vom Antwortcode und je nachdem, 
ob die automatische Zahlungserstattung aktiviert ist oder nicht, sieht die 
Webhook-Verarbeitungslogik aufseiten von Xsolla wie folgt aus:


    
    
        Antwortcode
        Automatische Zahlungserstattung ist deaktiviert (standardmäßig)
        Automatische Zahlungserstattung ist aktiviert
    
    
    
    
        400, 401, 402, 403, 404, 409, 422, 415
        Keine Aktionen
        Benutzer erhält automatische eine Erstattung
    
    
        200, 201, 204
        Keine Aktionen
        Keine Aktionen
    
    
        Anderer Code oder keine Antwort auf Webhook
        Mehrere Webhooks werden innerhalb eines bestimmten Zeitintervalls gesendet: Zwei Versuche im Abstand von 5 Minuten, sieben Versuche im Abstand von jeweils 15 Minuten, zehn Versuche im Abstand von jeweils 60 Minuten.
        Mehrere Webhooks werden innerhalb eines bestimmten Zeitintervalls gesendet: Zwei Versuche im Abstand von 5 Minuten, sieben Versuche im Abstand von jeweils 15 Minuten, zehn Versuche im Abstand von jeweils 60 Minuten. Wurden alle Webhooks gesendet, ohne eine erfolgreiche Antwort erhalten zu haben, wird dem Benutzer automatisch eine Erstattung ausgestellt.
    
    


Wenden Sie sich an Ihre Customer Success Manager oder senden Sie eine E-Mail an 
csm@xsolla.com, um die automatische Erstattungsfunktion zu verknüpfen.

## Personalisierungs-Webhook

### Katalogpersonalisierung aufseiten des Partners

 - [POST personalized-partner-catalog](https://developers.xsolla.com/de/webhooks/personalization/personalized-partner-catalog.md): Xsolla sendet den Webhook partner_side_catalog mitsamt der 
Benutzer- und Projektparameter an die Webhook-URL, wenn ein Benutzer mit dem 
Shop interagiert.

Geben Sie eine Liste der item_id oder der SKUs der für den 
Benutzer erhältlichen Artikel zurück. In diesem Fall können Sie auch die 
Information einfügen, dass ein bestimmter Benutzer eine bestimmte Menge eines 
bestimmten Produkts kaufen kann. Mit dieser Funktion können Sie die Anzahl und 
Art der Produkte steuern, die der Benutzer in den Warenkorb legen und kaufen 
kann.

Es wird empfohlen, den Webhook partner_side_catalog in weniger als 
drei Sekunden zu verarbeiten.

## Anti-fraud

### Anti-fraud-Sperrliste aktualisieren

 - [POST afs-rejected-blocklist](https://developers.xsolla.com/de/webhooks/anti-fraud/afs-rejected-blocklist.md): Wenn die Sperrliste des Anti-fraud-Systems aktualisiert wird (z. B. ein Parameter wird hinzugefügt oder entfernt), sendet Xsolla einen Webhook vom Typ afs_black_list an die Webhook-URL. Parameter werden automatisch aufseiten von Xsolla oder auf Anfrage hinzugefügt. Parameter zu entfernen, ist nur auf Anfrage möglich. Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie diesen Webhook erhalten möchten.

### Anti-fraud-System lehnt Transaktion ab

 - [POST afs-rejected-transaction](https://developers.xsolla.com/de/webhooks/anti-fraud/afs-rejected-transaction.md): Wird eine Transaktion während einer Prüfung vom Anti-fraud-System abgelehnt, 
sendet Xsolla die Transaktionsdetails in einem Webhook vom Typ afs_reject an 
die Webhook-URL. Wenden Sie sich an Ihren Customer Success Manager oder senden 
Sie eine E-Mail an csm@xsolla.com, wenn Sie 
diesen Webhook erhalten möchten.

Wenn Sie die Webhook-URL im Kundenportal speichern, können Sie Berechtigungen 
erteilen, detaillierte Informationen in Webhooks zu empfangen. Aktivieren Sie 
dazu im Kundenportal unter Projekteins
tellungen &gt; Webhooks &gt; Erweiterte Einstellungen den folgenden 
Schalter.


Hinweis
Wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter unter Projekteinstellungen &gt; Webhooks &gt; Testen &gt; Payments &gt; Erweiterte Einstellungen.




    
        Schalter
        Beschreibung
    


    
        Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden
        Informationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.saved_payment_method:0 – die gespeicherte Zahlungsmethode wurde nicht verwendet1 – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert2 – die zuvor gespeicherte Zahlungsmethode wird verwendetpayment_type:1 – Einmalzahlung2 – wiederkehrende Zahlung

### Streitfall

 - [POST dispute](https://developers.xsolla.com/de/webhooks/anti-fraud/dispute.md): Wenn ein neuer Streitfall eröffnet wird oder sich der Status eines Streitfalls ändert, sendet Xsolla einen Webhook vom Typ dispute an die Webhook-URL. Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie diesen Webhook erhalten möchten.

## Subscriptions

### Gekündigtes Abonnement

 - [POST canceled-subscription](https://developers.xsolla.com/de/webhooks/subscriptions/canceled-subscription.md): Wird ein Abonnement gekündigt, sendet Xsolla einen Webhook vom Typ cancel_subscription an die Webhook-URL.

### Abgeschlossenes Abonnement

 - [POST created-subscription](https://developers.xsolla.com/de/webhooks/subscriptions/created-subscription.md): Wenn ein Benutzer ein Abonnement abschließt, sendet Xsolla einen Webhook vom Typ create_subscription an die Webhook-URL.

### Automatisch endendes Abo

 - [POST nonrenewing-subscription](https://developers.xsolla.com/de/webhooks/subscriptions/nonrenewing-subscription.md): Wird für ein Abonnement der Status "Automatisch endend" festgelegt, sendet Xsolla einen Webhook vom Typ non_renewal_subscription an die Webhook-URL. Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie diesen Webhook erhalten möchten.

### Aktualisiertes Abonnement

 - [POST updated-subscription](https://developers.xsolla.com/de/webhooks/subscriptions/updated-subscription.md): Bei jeder Abonnementverlängerung, oder wenn bestimmte Abonnementparameter (plan_id, date_next_charge) geändert werden, sendet Xsolla einen Webhook vom Typ update_subscription an die Webhook-URL.