Hinweis
Je nach verwendeter Lösung und Art der Integration können die Webhooks und die Interaktionsabfolge vom angegebenen Beispiel abweichen.
\n| Produkt/Lösung | \nErforderlich/Optional | \nWozu die Webhooks verwendet werden | \n
|---|---|---|
| Payments | \nErforderlich | \n\n
| \n
| Store | \nErforderlich | \n\n
| \n
| Game Sales | \nOptional | \nFü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. Wenn Sie sich für Webhooks entscheiden, ist es wichtig, alle eingehenden erforderlichen Webhooks zu verarbeiten.\n | \n
| Subscriptions | \nOptional | \nZum Abrufen von Informationen über den Abschluss, die Aktualisierung oder die Kündigung eines Abonnements. Alternativ können Sie die Informationen auch über die API anfordern.\n | \n
| Web Shop | \nErforderlich | \n\n
| \n
| Digital Distribution Hub | \nErforderlich | \n\n
Ausführliche Informationen zum Einrichten von Webhooks für den Digital Distribution Hub finden Sie in der Dokumentation. \n | \n
| Login | \nOptional | \n\n Empfang von Ereignisinformationen: \n
Ausführliche Informationen zur Einrichtung von Webhooks finden Sie in der -Login-Dokumentation. \n | \n
| Webhook-Name und ‑Typ | \nBeschreibung | \n
|---|---|
Benutzervalidierung > Benutzervalidierung (user_validation) | \n Wird in verschiedenen Phasen des Zahlungsvorgangs gesendet, um sicherzustellen, dass der Nutzer im Spiel registriert ist. | \n
Spieldienste > kombinierte Webhooks > Erfolgreiche Bezahlung der Bestellung (order_paid) | \n Enthält Zahlungsdaten, Transaktionsdetails und Informationen über gekaufte Artikel. Verwenden Sie die Daten aus dem Webhook, um dem Nutzer Artikel zu gewähren. | \n
Spieldienste > kombinierte Webhooks > Stornierung der Bestellung (order_canceled) | \n 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. | \n
| Webhook-Name und ‑Typ | \nBeschreibung | \n
|---|---|
Benutzervalidierung > Benutzervalidierung (user_validation) | \n Wird in verschiedenen Phasen des Zahlungsvorgangs gesendet, um sicherzustellen, dass der Nutzer im Spiel registriert ist. | \n
Zahlungen > Zahlung (payment) | \n Enthält Zahlungsdaten und Transaktionsdetails. | \n
Spieldienste > separate Webhooks > Erfolgreiche Bezahlung der Bestellung (order_paid) | \n Enthält Informationen über gekaufte Artikel. Verwenden Sie die Daten aus dem Webhook, um dem Nutzer Artikel hinzuzufügen. | \n
Zahlungen > Erstattung (refund) | \n Enthält Zahlungsdaten und Transaktionsdetails. | \n
Spieldienste > separate Webhooks > Stornierung der Bestellung (order_canceled) | \n 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. | \n
Hinweis
\nUm echte Zahlungen entgegennehmen zu können, müssen Sie lediglich die Lizenzvereinbarung unterzeichnen und die Verarbeitung der folgenden Webhooks implementieren:
\nHinweis:
\nFür die Datenübertragung wird das HTTPS-Protokoll verwendet; das HTTP-Protokoll wird nicht unterstützt.
\nHinweis
\nEmpfehlungen:
Hinweis
\nWebhooks können Sie auch über eine beliebige zweckbestimmte Website (z. B. webhook.site) oder Plattform (z. B. ngrok) testen.
\nHinweis
\nSie 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.
\nHinweis
\nEmpfehlungen:
Hinweis
\nWenn die erweiterten Einstellungen nicht angezeigt werden, müssen Sie zuerst den Webhook-Empfang in den allgemeinen Einstellungen aktivieren und dann zur Registerkarte Testen > Payments und Store wechseln.
\n| Schalter | \nBeschreibung | \n
|---|---|
| Infos über das gespeicherte Zahlungskonto anzeigen (wird nur angezeigt, wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben und Webhooks separat empfangen). | \nInformationen über die gespeicherte Zahlungsmethode werden in dem benutzerdefinierten Objekt payment_account übermittelt. | \n
| Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden. | \nInformationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.
| \n
order-Objekt dem Webhook hinzufügen (wird nur angezeigt, wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben und Webhooks separat empfangen) | \n Die Informationen über die Bestellung werden im order-Objekt des Zahlung-Webhooks übermittelt. | \n
| Nur notwendige Nutzerparameter ohne vertrauliche Daten senden. | \nIm Webhook werden nur die folgenden Nutzerinformationen übermittelt:
| \n
| Individuelle Parameter senden. | \nInformationen über individuelle Tokenparameter werden in dem Webhook übermittelt. | \n
| BLZ und Endziffern von Karten anzeigen. | \nIm Webhook werden nur die folgenden Informationen über die Bankkartennummer übermittelt:
| \n
| Kartenmarke anzeigen. | \nDie Marke der Karte, mit der die Zahlung getätigt wurde. Zum Beispiel: Mastercard oder Visa. | \n
| Infos über den Erstattungsgrund anzeigen | \nAusführliche Informationen zu den Gründen der Erstattung. | \n
| Länder-Quellensteuer und Nutzerakquisitionsgebühr anzeigen | \nDie Objekte payment_details.country_wht und payment_details.user_acquisition_fee werden im Webhook übermittelt. Der Schalter ist standardmäßig aktiviert. | \n
| 3DS-Infos senden | \nDas Objekt cards mit den Daten für die \"3-D Secure\"-Prüfung wird im Webhook übermittelt. | \n
| Registerkartenname für Webhook-Tests | \nWebhook-Name und ‑Typ | \n
|---|---|
| Payments und Store | \nBenutzervalidierung > Benutzervalidierung (user_validation) | \n
| \n | Spieldienste > kombinierte Webhooks > Erfolgreiche Bezahlung der Bestellung (order_paid) | \n
| \n | Spieldienste > kombinierte Webhooks > Stornierung der Bestellung (order_canceled) | \n
| Subscriptions | \nBenutzervalidierung > Benutzervalidierung (user_validation) | \n
| \n | Zahlungen > Zahlung (payment) | \n
| Registerkartenname für Webhook-Tests | \nWebhook-Name und ‑Typ | \n
|---|---|
| Store | \nSpieldienste > separate Webhooks > Erfolgreiche Bezahlung der Bestellung (order_paid) | \n
| \n | Spieldienste > separate Webhooks > Stornierung der Bestellung (order_canceled) | \n
| Payments | \nBenutzervalidierung > Benutzervalidierung (user_validation) | \n
| \n | Zahlungen > Zahlung (payment) | \n
| Subscriptions | \nBenutzervalidierung > Benutzervalidierung (user_validation) | \n
| \n | Zahlungen > Zahlung (payment) | \n
Hinweis
\nWird im Testbereich eine Fehlermeldung angezeigt, wonach der Test nicht erfolgreich war, sollten Sie in den Einstellungen Ihres Webhook-Listener prüfen, wie dieser auf Webhooks antwortet. Die Gründe für den fehlgeschlagenen Test sind in den Testergebnissen ersichtlich.
\nBeispiel:
\nSie haben eine spezielle Website (z. B. webhook.site) zum Testen verwendet.
\nIm Abschnitt Test: Antwort auf eine ungültige Signatur wird ein Fehler angezeigt.
\nDas liegt daran, dass Xsolla einen Webhook mit falscher Signatur gesendet hat und nun erwartet, dass Ihr Handler mit dem HTTP-Statuscode 4xx und dem Fehlercode INVALID_SIGNATURE antwortet.
webhook.site antwortet allen Webhooks mit dem HTTP-Statuscode 200, selbst solchen Webhooks mit ungültiger Signatur. Weil der HTTP-Statuscode 4xx nicht wie erwartet empfangen wurde, ist das Testergebnis fehlerhaft.
Hinweis
\nUm Webhooks zu testen, sollten Sie mindestens ein Abo-Modell im Kundenportal unter dem Menüpunkt Artikelkatalog > Abonnements erstellt haben.
\nHinweis
\nAusführliche Informationen zum Testen anderer Abonnementverwaltungsszenarien finden Sie im Integrationsleitfaden.
\nHinweis
\nSie können die Pay Station PHP SDK-Bibliothek verwenden, die vorgefertigte Klassen für die Verarbeitung von Webhooks enthält.
\nHinweis
Verwenden Sie die JSON-Payload \n genau so, wie Sie sie erhalten haben. Die Payload darf nicht geparst oder neu \n codiert werden, da dies die Formatierung verändert, woraufhin die \n Signaturüberprüfung fehlschlägt.
Hinweis
\nDieses 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 ConstantTimeEquals-Methode zur Verhinderung von Timing-Angriffen.
Hinweis
\nUm die Convert.ToHexString-Methode nutzen zu können, brauchen Sie .NET 5.0 oder höher.
ConstantTimeEquals auch die CryptographicOperations.FixedTimeEquals-Methode verwenden.\nHinweis
\n Wenn Sie über .NET 7.0 oder höher verfügen, könne Sie die CryptographicOperations.FixedTimeEquals-Methode verwenden.
Hinweis
\nDie Zahlung wird dem Nutzer auch dann erstattet, wenn alle folgenden Bedingungen erfüllt sind:
4xx zurückgegeben, oder es wurde nach allen weiteren Zustellversuchen keine Antwort empfangen, oder es wurde der Statuscode 5xx zurückgegeben.| Code | \nNachricht | \n
|---|---|
| INVALID_USER | \nUngültiger Benutzer | \n
| INVALID_PARAMETER | \nUngültiger Parameter | \n
| INVALID_SIGNATURE | \nUnzulässige Signatur | \n
| INCORRECT_AMOUNT | \nUngültiger Betrag | \n
| INCORRECT_INVOICE | \nUngültige Rechnung | \n
Hinweis
\nWenn Sie die Integration lokal testen, erreichen `POST`-Anfragen von Xsolla keine URLs wie http://localhost:3000/my-webhook-endpoint. Nutzen Sie Dienste wie ngrok, mit denen Sie einen Tunnel für den externen Zugriff einrichten können, sodass Sie Anfragen von Xsolla lokal empfangen können. Weitere Informationen hierzu finden Sie beispielsweise in der ngrok-Dokumentation.
Hinweis
\nDer Benachrichtigungstyp wird im Parameter notification_type gesendet.
| Webhook | \nBenachrichtigungstyp | \nBeschreibung | \n
|---|---|---|
| Benutzervalidierung | \nuser_validation | \n Wird versendet, um zu prüfen, ob ein Benutzer im Spiel existiert. | \n
| Benutzersuche | \nuser_search | \n Wird versendet, um Benutzerinformationen anhand der öffentlichen Benutzer-ID abzurufen. | \n
| Zahlung | \npayment | \n Wird versendet, wenn ein Benutzer eine Zahlung abschließt. | \n
| Erstattung | \nrefund | \n Wird versendet, falls eine Zahlung aus einem beliebigen Grund storniert werden muss. | \n
| Teilerstattung | \npartial_refund | \n Wird versendet, falls eine Zahlung aus einem beliebigen Grund teilweise storniert werden muss. | \n
| Abgelehnte Zahlung | \nps_declined | \n Wird versendet, wenn eine Zahlung vom Zahlungssystem abgelehnt wird. | \n
| Abgelehnte Transaktion (AFS) | \nafs_reject | \n Wird versendet, wenn eine Transaktion während einer AFS-Prüfung abgelehnt wird. | \n
| Aktualisierte AFS-Blockliste | \nafs_black_list | \n Wird bei Aktualisierung der AFS-Blockliste versendet. | \n
| Abgeschlossenes Abonnement | \ncreate_subscription | \n Wird versendet, wenn ein Benutzer ein Abonnement abschließt. | \n
| Aktualisiertes Abonnement | \nupdate_subscription | \n Wird versendet, wenn ein Abonnement erneuert oder geändert wird. | \n
| Storniertes Abonnement | \ncancel_subscription | \n Wird versendet, wenn ein Abonnement gekündigt wird. | \n
| Automatisch endendes Abonnement | \nnon_renewal_subscription | \n Wird versendet, wenn der Status auf \"Automatisch endend\" gesetzt wird. | \n
| Zahlungskonto hinzufügen | \npayment_account_add | \n Wird versendet, wenn ein Benutzer ein Zahlungskonto hinzufügt oder speichert. | \n
| Zahlungskonto entfernen | \npayment_account_remove | \n Wird versendet, wenn ein Benutzer das Zahlungskonto aus den gespeicherten Konten entfernt. | \n
| Benutzervalidierung im Web Shop | \n- | \n Wird von einer Web Shop-Seite gesendet, um zu prüfen, ob ein Benutzer im Spiel vorhanden ist. | \n
| Katalogpersonalisierung aufseiten des Partners | \npartner_side_catalog | \n Wird gesendet, wenn ein Benutzer mit dem Shop interagiert. | \n
| Erfolgreiche Bezahlung der Bestellung | \norder_paid | \n Wird gesendet, wenn eine Bestellung bezahlt wurde. | \n
| Stornierung der Bestellung | \norder_canceled | \n Wird gesendet, wenn eine Bestellung storniert wird. | \n
| Streitfall | \ndispute | \n Wird gesendet, wenn ein neuer Streiftall eröffnet wird. | \n
Hinweis
\nWenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter unter Projekteinstellungen > Webhooks > Testen > Payments > Erweiterte Einstellungen.
\n| Schalter | \nBeschreibung | \n
|---|---|
| Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden | \nInformationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.
| \n
| Erstattungsinitiator | \nFeldwert | \n
|---|---|
| Spiel (über API). | \nAPI | \n
| Kundenportal-Nutzer (automatische Erstattung). | \nE-Mail-Adresse des Nutzers | \n
| Kundenportal-Nutzer (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
| Xsolla (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
| Code | \nGrund | \nBeschreibung | \n
|---|---|---|
| 1 | \nCancellation by the user request / the game request | \nAus dem Kundenportal heraus eingeleitete Stornierung. | \n
| 2 | \nChargeback | \nRückbuchung der Transaktion angefordert. | \n
| 3 | \nIntegration error | \nIntegrationsprobleme zwischen Xsolla und dem Spiel. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 4 | \nPotential fraud | \nBetrugsverdacht. Empfehlung: Benutzer auf Sperrliste setzen. | \n
| 5 | \nTest payment | \nTestweise getätigte Transaktion gefolgt von Stornierung. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 6 | \nUser invoice expired | \nRechnung überfällig (wird bei Postpaid-Zahlungsweise genutzt). | \n
| 7 | \nFraud notification from PS | \nZahlung wurde vom Zahlungssystem abgelehnt. Potenzieller Betrug durch Zahlungssystem entdeckt. Empfehlung: Benutzer auf Sperrliste setzen. | \n
| 8 | \nCancellation by the PS request | \nZahlungssystem hat Stornierung angefordert. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 9 | \nCancellation by the user request | \nDer Benutzer war aus irgendeinem Grund nicht zufrieden mit dem Spiel oder dem Einkauf. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 10 | \nCancellation by the game request | \nDas Spiel hat die Stornierung angefordert. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 11 | \nAccount holder called to report fraud | \nDer Kontoinhaber gibt an, dass die Transaktion nicht von ihm getätigt wurde. | \n
| 12 | \nFriendly fraud | \nEs wurde ein \"Friendly Fraud\" gemeldet. | \n
| 13 | \nDuplicate | \nDuplizierte Transaktion für dieselbe Rechnung. | \n
order_canceled an die angegebene URL, \nwenn die Zahlung vom Nutzer, Partner oder automatisch storniert wurde. Der \nWebhook enthält Informationen über zurückgesandte Artikel, Zahlungsdaten und \nDetails zur stornierten Bestellung.\n\nDer Webhook wird nicht gesendet, wenn die Zahlung nicht erfolgreich war, zum \nBeispiel:\n* das Zahlungsportal geöffnet wurde, aber der Nutzer die Bestellung nicht bezahlt \n hat\n* das Zahlungsportal geöffnet wurde, aber während der Zahlung Fehler auftraten\n\nDie empfohlene Verarbeitungszeit für Webhooks beträgt maximal drei Sekunden.\n",
"operationId": "order-cancellation",
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"billing": {
"description": "Transaktions- und Zahlungsdetails.",
"properties": {
"notification_type": {
"$ref": "#/components/schemas/notification_type"
},
"payment_details": {
"description": "Zahlungsdaten (Objekt).",
"properties": {
"country_wht": {
"$ref": "#/components/schemas/country_whc"
},
"direct_wht": {
"description": "Direkte Quellensteuer.",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
},
"percent": {
"description": "Direkter Quellensteuersatz.",
"format": "float",
"type": "number"
}
},
"type": "object"
},
"payment": {
"description": "Vom Benutzer entrichteter Betrag (Objekt).",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
}
},
"type": "object"
},
"payment_method_fee": {
"description": "Gebühren des Zahlungssystems.",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
}
},
"type": "object"
},
"payment_method_sum": {
"description": "Betrag, der vom Zahlungssystem abgebucht wird.",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
}
},
"type": "object"
},
"payout": {
"description": "Details zur Auszahlung (Objekt).",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
}
},
"type": "object"
},
"payout_currency_rate": {
"description": "Wechselkurs zwischen Zahlungs- und Auszahlungswährung.",
"type": "string"
},
"repatriation_commission": {
"description": "Objekt mit Daten über die Rückübertragungskosten, die Xsolla von Dritten auferlegt wurden.",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
}
},
"type": "object"
},
"sales_tax": {
"description": "Sales Tax (Objekt; nur in den USA und Kanada).",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
},
"percent": {
"description": "Sales-Tax-Steuersatz.",
"format": "float",
"type": "number"
}
},
"type": "object"
},
"user_acquisition_fee": {
"description": "Der Gesamtbetrag der Nutzerakquisitionsgebühren, der für die durch Affiliate-Netzwerke und Influencer vermittelten Käufe abgezogen wird (Objekt).",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
},
"percent": {
"description": "Gebührensatz für die Nutzerakquise (in %).",
"format": "float",
"type": "number"
}
},
"type": "object"
},
"vat": {
"description": "Angaben zur MwSt. (Objekt, nur in der EU).",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
},
"percent": {
"description": "Mehrwertsteuersatz.",
"format": "float",
"type": "number"
}
},
"type": "object"
},
"xsolla_balance_sum": {
"description": "Betrag, der vom Xsolla-Konto abgebucht wird.",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
}
},
"type": "object"
},
"xsolla_fee": {
"description": "Xsolla-Gebühr (Objekt).",
"properties": {
"amount": {
"description": "Betrag.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
}
},
"type": "object"
}
},
"type": "object"
},
"purchase": {
"description": "Objekt, welches Angaben zum Kauf enthält.",
"properties": {
"subscription": {
"description": "Angaben zum Abonnement (Objekt).",
"properties": {
"amount": {
"$ref": "#/components/schemas/amount-float"
},
"currency": {
"$ref": "#/components/schemas/currency"
},
"date_create": {
"$ref": "#/components/schemas/subscription.date_create"
},
"plan_id": {
"$ref": "#/components/schemas/subscription.plan_id"
},
"subscription_id": {
"$ref": "#/components/schemas/subscription.subscription_id"
},
"tags": {
"$ref": "#/components/schemas/subscription.tags"
}
},
"type": "object"
},
"total": {
"description": "Gesamtpreis des Einkaufs (Objekt).",
"properties": {
"amount": {
"description": "Gesamtbetrag der Zahlung.",
"format": "float",
"type": "number"
},
"currency": {
"$ref": "#/components/schemas/currency"
}
},
"type": "object"
}
},
"required": [
"total"
],
"type": "object"
},
"refund_details": {
"description": "Benutzerdaten (Objekt).",
"properties": {
"author": {
"description": "Erstattungsinitiator. Der Feldwert wird gemäß der Tabelle übermittelt:\n\n| Erstattungsinitiator | \nFeldwert | \n
|---|---|
| Spiel (über API). | \nAPI | \n
| Kundenportal-Nutzer (automatische Erstattung). | \nE-Mail-Adresse des Nutzers | \n
| Kundenportal-Nutzer (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
| Xsolla (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
order_canceled an die angegebene URL, \nwenn die Zahlung vom Nutzer, Partner oder automatisch storniert wurde. Der \nWebhook enthält Informationen über zurückgesandte Artikel und Details zur \nstornierten Bestellung.\n\nDer Webhook wird nicht gesendet, wenn die Zahlung nicht erfolgreich war, zum \nBeispiel:\n* das Zahlungsportal geöffnet wurde, aber der Nutzer die Bestellung nicht bezahlt \n hat\n* das Zahlungsportal geöffnet wurde, aber während der Zahlung Fehler auftraten\n\nDie empfohlene Verarbeitungszeit für Webhooks beträgt maximal drei Sekunden.\n",
"operationId": "order-cancellation-separate",
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"custom_parameters": {
"description": "Zusätzliche Informationen.",
"type": "object"
},
"items": {
"description": "Liste der vom Nutzer gekauften Artikel.\n\nDie im Array enthaltenen Parameter hängen von der Webhook-Version ab. In \nVersion 2 sind zusätzliche Parameter enthalten: `is_free`, `is_bonus` und \n`is_bundle_content`. Geben Sie die entsprechende Nummer im Parameter `version` \nim API-Aufruf [Informationen zu Webhook-Einstellungen \naktualisieren](/de/api/igs/operation/update-webhook/) an, um die Version zu \nwechseln.\n",
"items": {
"oneOf": [
{
"properties": {
"amount": {
"description": "Gesamtkosten der Artikel basierend auf ihrer Menge.",
"type": "string"
},
"custom_attributes": {
"description": "Ein JSON-Objekt mit Artikelattributen und ‑werten.",
"type": "object"
},
"is_pre_order": {
"description": "Ist `true` festgelegt, kann der Artikel vorbestellt werden.",
"type": "boolean"
},
"promotions": {
"$ref": "#/components/schemas/items.promotions"
},
"quantity": {
"description": "Menge der Gegenstände.",
"type": "integer"
},
"sku": {
"$ref": "#/components/schemas/items.sku"
},
"type": {
"$ref": "#/components/schemas/items.type"
}
},
"required": [
"sku",
"type",
"quantity",
"amount",
"promotions",
"is_pre_order"
],
"title": "Version = 1",
"type": "object"
},
{
"properties": {
"amount": {
"description": "Gesamtkosten der Artikel basierend auf ihrer Menge.",
"type": "string"
},
"custom_attributes": {
"description": "Ein JSON-Objekt mit Artikelattributen und ‑werten.",
"type": "object"
},
"is_bonus": {
"description": "Ist `true` festgelegt, ist der Artikel ein Bonus.",
"type": "boolean"
},
"is_bundle_content": {
"description": "Ist `true` festgelegt, gehört der Artikel zu einem Bundle.",
"type": "boolean"
},
"is_free": {
"description": "Ist `true` festgelegt, ist der Artikel kostenlos.",
"type": "boolean"
},
"is_pre_order": {
"description": "Ist `true` festgelegt, kann der Artikel vorbestellt werden.",
"type": "boolean"
},
"promotions": {
"description": "Angewandte Werbeaktion. Falls keine Werbeaktion angewandt wurde, wird ein leeres Array im Parameter übermittelt.",
"items": {
"properties": {
"amount_with_discount": {
"description": "Gesamtkosten der Gegenstände inklusive Rabatt.",
"type": "string"
},
"amount_without_discount": {
"description": "Gesamtkosten der Gegenstände ohne Rabatt.",
"type": "string"
},
"sequence": {
"description": "Reihenfolge der angewandten Werbeaktionen.",
"type": "integer"
}
},
"type": "object"
},
"type": "array"
},
"quantity": {
"description": "Menge der Gegenstände.",
"type": "integer"
},
"sku": {
"$ref": "#/components/schemas/items.sku"
},
"type": {
"$ref": "#/components/schemas/items.type"
}
},
"required": [
"sku",
"type",
"quantity",
"amount",
"promotions",
"is_pre_order",
"is_free",
"is_bonus",
"is_bundle_content"
],
"title": "Version = 2",
"type": "object"
}
]
},
"type": "array"
},
"notification_type": {
"$ref": "#/components/schemas/notification_type"
},
"order": {
"description": "Bestellinformationen.",
"properties": {
"amount": {
"description": "Die Gesamtkosten eines Warenkorbs basierend auf der gewählten Währung.",
"type": "string"
},
"comment": {
"description": "Benutzeranmerkung der Bestellung.",
"nullable": true,
"type": "string"
},
"coupons": {
"description": "Angewandte Gutscheine. Wird der Gutschein nicht angewendet, wird kein Array zurückgegeben.",
"items": {
"properties": {
"code": {
"description": "Der Code eines angewandten Gutscheins.",
"type": "string"
},
"external_id": {
"description": "Externe ID.",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"currency": {
"description": "Währung der Bestellung. Bei virtuellen Währungen wird die SKU und bei echten Währungen der aus drei Buchstaben bestehende Code gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) genutzt.",
"type": "string"
},
"currency_type": {
"$ref": "#/components/schemas/currency-type"
},
"id": {
"description": "Eindeutige Kennung der Bestellung des Benutzers aufseiten von Xsolla.",
"type": "integer"
},
"invoice_id": {
"description": "Rechnungs-ID bei Zahlungen mit echter Währung. Bei Zahlungen mit virtueller Währung oder bei kostenlosen Artikeln wird der Wert `null` genutzt.",
"nullable": true,
"type": "string"
},
"mode": {
"description": "Zahlungsmodus. `default` wird bei realen Zahlungen verwendet; `sandbox` bei Testzahlungen.",
"enum": [
"default",
"sandbox"
],
"type": "string"
},
"platform": {
"description": "Zahlungsplattform. Bei Zahlungen über Xsolla wird der Wert `xsolla` verwendet. Bei anderen Zahlungen entspricht der Wert dem Namen der Publishing-Plattform: `playstation_network`, `xbox_live`, `pc_standalone`, `nintendo_shop`, `google_play`, `app_store_ios`, `android_standalone`, `ios_standalone`, `android_other`, `ios_other`, `pc_other`.",
"enum": [
"xsolla",
"playstation_network",
"xbox_live",
"pc_standalone",
"nintendo_shop",
"google_play",
"app_store_ios",
"android_standalone",
"ios_standalone",
"android_other",
"ios_other",
"pc_other"
],
"nullable": true,
"type": "string"
},
"promocodes": {
"description": "Angewandte Promocodes. Wird der Promocode nicht angewandt, wird kein Array zurückgegeben.",
"items": {
"properties": {
"code": {
"description": "Der Code eines angewandten Promocodes.",
"type": "string"
},
"external_id": {
"description": "Externe ID.",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"promotions": {
"$ref": "#/components/schemas/order.promotions"
},
"status": {
"description": "Bestellstatus.",
"type": "string"
}
},
"required": [
"id",
"mode",
"currency_type",
"currency",
"amount",
"status",
"platform",
"comment",
"invoice_id",
"promotions"
],
"type": "object"
},
"user": {
"description": "Benutzerinformationen.",
"properties": {
"country": {
"$ref": "#/components/schemas/user.country"
},
"email": {
"description": "E-Mail-Adresse des Benutzers.",
"type": "string"
},
"external_id": {
"description": "Benutzer-ID.",
"type": "string"
}
},
"required": [
"external_id",
"email"
],
"type": "object"
}
},
"required": [
"notification_type",
"items",
"order",
"user"
]
}
}
}
},
"responses": {
"200": {
"description": "Zur Signalisierung einer erfolgreiche Verarbeitung."
},
"400": {
"description": "Im Falle eines Fehlers in den bereitgestellten Daten (z. B. fehlender erforderlicher Parameter, fehlgeschlagene Autorisierung usw.)."
}
},
"summary": "Stornierung der Bestellung (ohne Zahlungs- und Transaktionsdetails)",
"tags": [
"separate-webhooks"
],
"x-codeSamples": [
{
"label": "CURL",
"lang": "cURL",
"source": "curl -v 'https://your.hostname/your/uri' \\\n-X POST \\\n-H 'accept: application/json' \\\n-H 'content-type: application/json' \\\n-H 'authorization: Signature d09695066c52c1b8bdae92f2d6eb59f5b5f89843' \\\n-d '{\n \"notification_type\": \"order_canceled\",\n \"items\": [\n {\n \"sku\": \"com.xsolla.v.item_1\",\n \"type\": \"virtual_good\",\n \"is_pre_order\": false,\n \"quantity\": 3,\n \"amount\": \"1000\",\n \"promotions\": [\n {\n \"amount_without_discount\": \"6000\",\n \"amount_with_discount\": \"5000\",\n \"sequence\": 1\n },\n {\n \"amount_without_discount\": \"5000\",\n \"amount_with_discount\": \"4000\",\n \"sequence\": 2\n }\n ],\n \"custom_attributes\": {\n \"purchased\": 0,\n \"attr\": \"value\"\n }\n },\n {\n \"sku\": \"com.xsolla.v.item_new_1\",\n \"type\": \"bundle\",\n \"is_pre_order\": false,\n \"quantity\": 1,\n \"amount\": \"1000\",\n \"promotions\": []\n },\n {\n \"sku\": \"com.xsolla.gold_1\",\n \"type\": \"virtual_currency\",\n \"is_pre_order\": false,\n \"quantity\": 1500,\n \"amount\": \"[null]\",\n \"promotions\": []\n }\n ],\n \"order\": {\n \"id\": 1,\n \"mode\": \"default\",\n \"currency_type\": \"virtual\",\n \"currency\": \"sku_currency\",\n \"amount\": \"2000\",\n \"status\": \"paid\",\n \"platform\": \"xsolla\",\n \"comment\": null,\n \"invoice_id\": \"1\",\n \"promotions\": [\n {\n \"amount_without_discount\": \"4000\",\n \"amount_with_discount\": \"2000\",\n \"sequence\": 1\n }\n ],\n \"promocodes\": [\n {\n \"code\": \"promocode_some_code\",\n \"external_id\": \"promocode_sku\"\n }\n ],\n \"coupons\": [\n {\n \"code\": \"WINTER2021\",\n \"external_id\": \"coupon_sku\"\n }\n ]\n },\n \"user\": {\n \"external_id\": \"id_xsolla_login_1\",\n \"email\": \"email@example.com\",\n \"country\": \"US\"\n }\n\n}'"
},
{
"label": "HTTP",
"lang": "HTTP",
"source": "POST /your/uri HTTP/1.1\nhost: your.hostname\naccept: application/json\ncontent-length: 258\ncontent-type: application/json\nauthorization: Signature d90d319f05df7b0f86d2485f48e7079f0f752523\n\n\n{\n \"notification_type\": \"order_canceled\",\n \"items\": [\n {\n \"sku\": \"com.xsolla.v.item_1\",\n \"type\": \"virtual_good\",\n \"is_pre_order\": false,\n \"quantity\": 3,\n \"amount\": \"1000\",\n \"promotions\": [\n {\n \"amount_without_discount\": \"6000\",\n \"amount_with_discount\": \"5000\",\n \"sequence\": 1\n },\n {\n \"amount_without_discount\": \"5000\",\n \"amount_with_discount\": \"4000\",\n \"sequence\": 2\n }\n ],\n \"custom_attributes\": {\n \"purchased\": 0,\n \"attr\": \"value\"\n }\n },\n {\n \"sku\": \"com.xsolla.v.item_new_1\",\n \"type\": \"bundle\",\n \"is_pre_order\": false,\n \"quantity\": 1,\n \"amount\": \"1000\",\n \"promotions\": []\n },\n {\n \"sku\": \"com.xsolla.gold_1\",\n \"type\": \"virtual_currency\",\n \"is_pre_order\": false,\n \"quantity\": 1500,\n \"amount\": \"[null]\",\n \"promotions\": []\n }\n ],\n \"order\": {\n \"id\": 1,\n \"mode\": \"default\",\n \"currency_type\": \"virtual\",\n \"currency\": \"sku_currency\",\n \"amount\": \"2000\",\n \"status\": \"paid\",\n \"platform\": \"xsolla\",\n \"comment\": null,\n \"invoice_id\": \"1\",\n \"promotions\": [\n {\n \"amount_without_discount\": \"4000\",\n \"amount_with_discount\": \"2000\",\n \"sequence\": 1\n }\n ],\n \"promocodes\": [\n {\n \"code\": \"promocode_some_code\",\n \"external_id\": \"promocode_sku\"\n }\n ],\n \"coupons\": [\n {\n \"code\": \"WINTER2021\",\n \"external_id\": \"coupon_sku\"\n }\n ]\n },\n \"user\": {\n \"external_id\": \"id_xsolla_login_1\",\n \"email\": \"email@example.com\",\n \"country\": \"US\"\n }\n}"
}
]
}
},
"partial-refund": {
"post": {
"description": "Wird ein Betrag teilweise erstattet, sendet Xsolla die Details der stornierten \nTransaktion in einem Webhook vom Typ `partial_refund` an die Webhook-URL. \nWeitere Informationen zu Teilerstattungen finden Sie in dieser [Anleitung](/de/doc/pay-station/features/refund/#pay_station_features_refund_how_it_works_partial_refund_flow).\n\nWenn Sie die Webhook-URL im Kundenportal speichern, können Sie Berechtigungen \nerteilen, detaillierte Informationen in Webhooks zu empfangen. Aktivieren Sie \ndazu im Kundenportal unter Projekteins\ntellungen > Webhooks > Erweiterte Einstellungen den folgenden \nSchalter.\n\nHinweis
\nWenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter unter Projekteinstellungen > Webhooks > Testen > Payments > Erweiterte Einstellungen.
\n| Schalter | \nBeschreibung | \n
|---|---|
| Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden | \nInformationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.
| \n
| Code | \nGrund | \nBeschreibung | \n
|---|---|---|
| 1 | \nCancellation by the user request / the game request | \nAus dem Kundenportal heraus eingeleitete Stornierung. | \n
| 3 | \nIntegration error | \nIntegrationsprobleme zwischen Xsolla und dem Spiel. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 5 | \nTest payment | \nTestweise getätigte Transaktion gefolgt von Stornierung. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 7 | \nFraud notification from PS | \nZahlung wurde vom Zahlungssystem abgelehnt. Potenzieller Betrug durch Zahlungssystem entdeckt. Empfehlung: Benutzer auf Sperrliste setzen. | \n
| 9 | \nCancellation by the user request | \nDer Benutzer war aus irgendeinem Grund nicht zufrieden mit dem Spiel oder dem Einkauf. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 10 | \nCancellation by the game request | \nDas Spiel hat die Stornierung angefordert. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| Erstattungsinitiator | \nFeldwert | \n
|---|---|
| Spiel (über API). | \nAPI | \n
| Kundenportal-Nutzer (automatische Erstattung). | \nE-Mail-Adresse des Nutzers | \n
| Kundenportal-Nutzer (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
| Xsolla (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
| Antwortcode | \nBeschreibung | \n
|---|---|
200, 201, 204 | \n Eine erfolgreiche Antwort. | \n
4xx | \n Ein Fehler ist aufgetreten. Beispielsweise wurde der angegebene Nutzer nicht gefunden oder eine ungültige Signatur wurde übermittelt. | \n
5xx | \n 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. | \n
Hinweis
\nWenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter in Ihre Projekt unter Einstellungen > Webhooks > Testen > Payments > Erweiterte Einstellungen.
\n| Schalter | \nBeschreibung | \n
|---|---|
| Infos über das gespeicherte Zahlungskonto anzeigen | \nInformationen über die gespeicherte Zahlungsmethode werden in dem benutzerdefinierten Objekt payment_account übermittelt. | \n
| Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden | \nInformationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.
| \n
| Bestellobjekt dem Webhook hinzufügen | \nDie Informationen über die Bestellung werden im order-Objekt des Zahlung-Webhooks übermittelt. | \n
| Nur notwendige Nutzerparameter ohne vertrauliche Daten senden | \nIm Webhook werden nur die folgenden Nutzerinformationen übermittelt:
| \n
| BLZ und Endziffern von Karten anzeigen | \nIm Webhook werden nur die folgenden Informationen über die Bankkartennummer übermittelt:
| \n
| Kartenmarke anzeigen | \nDie Marke der Karte, mit der die Zahlung getätigt wurde. Zum Beispiel: Mastercard oder Visa. | \n
| Länder-Quellensteuer und Nutzerakquisitionsgebühr anzeigen | \nDie Objekte payment_details.country_wht und payment_details.user_acquisition_fee werden im Webhook übermittelt. Der Schalter ist standardmäßig aktiviert. | \n
| 3DS-Infos senden | \nDas Objekt cards mit den Daten für die \"3-D Secure\"-Prüfung wird im Webhook übermittelt. | \n
Hinweis
\nDie in einem Webhook versendeten Felder hängen von Folgendem ab:
Bei Fragen wenden Sie sich bitte an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.
\nHinweis
\n 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.
| Erstattungsinitiator | \nFeldwert | \n
|---|---|
| Spiel (über API). | \nAPI | \n
| Kundenportal-Nutzer (automatische Erstattung). | \nE-Mail-Adresse des Nutzers | \n
| Kundenportal-Nutzer (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
| Xsolla (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
| Code | \nGrund | \nBeschreibung | \n
|---|---|---|
| 1 | \nCancellation by the user request / the game request | \nAus dem Kundenportal heraus eingeleitete Stornierung. | \n
| 2 | \nChargeback | \nRückbuchung der Transaktion angefordert. | \n
| 3 | \nIntegration error | \nIntegrationsprobleme zwischen Xsolla und dem Spiel. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 4 | \nPotential fraud | \nBetrugsverdacht. Empfehlung: Benutzer auf Sperrliste setzen. | \n
| 5 | \nTest payment | \nTestweise getätigte Transaktion gefolgt von Stornierung. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 6 | \nUser invoice expired | \nRechnung überfällig (wird bei Postpaid-Zahlungsweise genutzt). | \n
| 7 | \nFraud notification from PS | \nZahlung wurde vom Zahlungssystem abgelehnt. Potenzieller Betrug durch Zahlungssystem entdeckt. Empfehlung: Benutzer auf Sperrliste setzen. | \n
| 8 | \nCancellation by the PS request | \nZahlungssystem hat Stornierung angefordert. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 9 | \nCancellation by the user request | \nDer Benutzer war aus irgendeinem Grund nicht zufrieden mit dem Spiel oder dem Einkauf. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 10 | \nCancellation by the game request | \nDas Spiel hat die Stornierung angefordert. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 11 | \nAccount holder called to report fraud | \nDer Kontoinhaber gibt an, dass die Transaktion nicht von ihm getätigt wurde. | \n
| 12 | \nFriendly fraud | \nEs wurde ein \"Friendly Fraud\" gemeldet. | \n
| 13 | \nDuplicate | \nDuplizierte Transaktion für dieselbe Rechnung. | \n
partner_side_catalog mitsamt der \nBenutzer- und Projektparameter an die Webhook-URL, wenn ein Benutzer mit dem \nShop interagiert.\n\nGeben Sie eine Liste der item_id oder der SKUs der für den \nBenutzer erhältlichen Artikel zurück. In diesem Fall können Sie auch die \nInformation einfügen, dass ein bestimmter Benutzer eine bestimmte Menge eines \nbestimmten Produkts kaufen kann. Mit dieser Funktion können Sie die Anzahl und \nArt der Produkte steuern, die der Benutzer in den Warenkorb legen und kaufen \nkann.\n\nHinweis
\nBeachten Sie bei der Verarbeitung des Webhooks die folgenden Einschränkungen:
Hinweis
\nDie Zahlung wird dem Nutzer auch dann erstattet, wenn alle folgenden Bedingungen erfüllt sind:
4xx zurückgegeben, oder es wurde nach allen weiteren Zustellversuchen keine Antwort empfangen, oder es wurde der Statuscode 5xx zurückgegeben.Hinweis
\nWenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter in Ihre Projekt unter Einstellungen > Webhooks > Testen > Payments > Erweiterte Einstellungen.
\n| Schalter | \nBeschreibung | \n
|---|---|
| Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden | \nInformationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.
| \n
| Infos über den Erstattungsgrund anzeigen | \nAusführliche Informationen zu den Gründen der Erstattung. | \n
| Code | \nGrund | \nBeschreibung | \n
|---|---|---|
| 1 | \nCancellation by the user request / the game request | \nAus dem Kundenportal heraus eingeleitete Stornierung. | \n
| 2 | \nChargeback | \nRückbuchung der Transaktion angefordert. | \n
| 3 | \nIntegration error | \nIntegrationsprobleme zwischen Xsolla und dem Spiel. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 4 | \nPotential fraud | \nBetrugsverdacht. Empfehlung: Benutzer auf Sperrliste setzen. | \n
| 5 | \nTest payment | \nTestweise getätigte Transaktion gefolgt von Stornierung. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 6 | \nUser invoice expired | \nRechnung überfällig (wird bei Postpaid-Zahlungsweise genutzt). | \n
| 7 | \nFraud notification from PS | \nZahlung wurde vom Zahlungssystem abgelehnt. Potenzieller Betrug durch Zahlungssystem entdeckt. Empfehlung: Benutzer auf Sperrliste setzen. | \n
| 8 | \nCancellation by the PS request | \nZahlungssystem hat Stornierung angefordert. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 9 | \nCancellation by the user request | \nDer Benutzer war aus irgendeinem Grund nicht zufrieden mit dem Spiel oder dem Einkauf. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 10 | \nCancellation by the game request | \nDas Spiel hat die Stornierung angefordert. Empfehlung: Benutzer nicht auf Sperrliste setzen. | \n
| 11 | \nAccount holder called to report fraud | \nDer Kontoinhaber gibt an, dass die Transaktion nicht von ihm getätigt wurde. | \n
| 12 | \nFriendly fraud | \nEs wurde ein \"Friendly Fraud\" gemeldet. | \n
| 13 | \nDuplicate | \nDuplizierte Transaktion für dieselbe Rechnung. | \n
| Erstattungsinitiator | \nFeldwert | \n
|---|---|
| Spiel (über API). | \nAPI | \n
| Kundenportal-Nutzer (automatische Erstattung). | \nE-Mail-Adresse des Nutzers | \n
| Kundenportal-Nutzer (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
| Xsolla (mit Unterstützung des Xsolla-Kundensupports). | \nsupport@xsolla.com | \n
order_paid an die angegebene URL, wenn \nder Nutzer die Bestellung erfolgreich bezahlt hat.\n\nDer Webhook order_paid enthält Informationen zu den gekauften \nArtikeln, Zahlungsdaten und Transaktionsdetails.\n\nDer Webhook order_paid wird nicht gesendet, wenn die Zahlung nicht \nerfolgreich war, zum Beispiel:\n* die Zahlungsmaske geöffnet wurde, aber der Benutzer die Bestellung nicht \n bezahlt hat\n* die Zahlungsmaske geöffnet wurde, aber während der Zahlung Fehler auftraten\n\nEs wird empfohlen, den Webhook order_paid in weniger als drei \nSekunden zu verarbeiten.\n\nHinweis
\nDie in einem Webhook versendeten Felder hängen von den folgenden Einstellungen ab:
Bei Fragen wenden Sie sich bitte an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.
\n| Antwortcode | \nAutomatische Zahlungserstattung ist deaktiviert (standardmäßig) | \nAutomatische Zahlungserstattung ist aktiviert | \n
|---|---|---|
400, 401, 402, 403, 404, 409, 422, 415 | \n Keine Aktionen | \nBenutzer erhält automatische eine Erstattung | \n
200, 201, 204 | \n Keine Aktionen | \nKeine Aktionen | \n
| Anderer Code oder keine Antwort auf Webhook | \nMehrere 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. | \nMehrere 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. | \n
order_paid an die angegebene URL, wenn \ndie folgenden Bedingungen erfüllt sind:\n1. Der Benutzer hat die Bestellung erfolgreich bezahlt.\n2. Xsolla hat eine Antwort über die erfolgreiche Verarbeitung des Webhooks \n [Zahlung](/de/webhooks/operation/payment/) erhalten.\n\nDer Webhook order_paid enthält Informationen zu den gekauften \nArtikeln und Transaktionsdetails.\n\nDer Webhook order_paid wird nicht gesendet, wenn:\n* die Zahlung nicht erfolgreich war, zum Beispiel:\n * die Zahlungsmaske geöffnet wurde, aber der Benutzer die Bestellung nicht \n bezahlt hat\n * die Zahlungsmaske geöffnet wurde, aber während der Zahlung Fehler auftraten\n* die Antwort über die erfolgreiche Verarbeitung des Webhooks \n [Zahlung](/de/webhooks/operation/payment/) nicht eingegangen ist.\n\nEs wird empfohlen, den Webhook order_paid in weniger als drei \nSekunden zu verarbeiten.\n\nDie erwarteten Antworten sind im Abschnitt Antworten beschrieben. Sie \nkönnen andere Antwortcodes verwenden. Abhängig vom Antwortcode und je nachdem, \nob die automatische Zahlungserstattung aktiviert ist oder nicht, sieht die \nWebhook-Verarbeitungslogik aufseiten von Xsolla wie folgt aus:\n\n| Antwortcode | \nAutomatische Zahlungserstattung ist deaktiviert (standardmäßig) | \nAutomatische Zahlungserstattung ist aktiviert | \n
|---|---|---|
400, 401, 402, 403, 404, 409, 422, 415 | \n Keine Aktionen | \nBenutzer erhält automatische eine Erstattung | \n
200, 201, 204 | \n Keine Aktionen | \nKeine Aktionen | \n
| Anderer Code oder keine Antwort auf Webhook | \nMehrere 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. | \nMehrere 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. | \n
Hinweis
\nWenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter unter Projekteinstellungen > Webhooks > Testen > Payments > Erweiterte Einstellungen.
\n| Schalter | \nBeschreibung | \n
|---|---|
| Nur notwendige Nutzerparameter ohne vertrauliche Daten senden | \nIm Webhook werden nur die folgenden Nutzerinformationen übermittelt:
| \n
| Individuelle Parameter senden | \nInformationen über individuelle Tokenparameter werden in dem Webhook übermittelt. | \n
custom_parameters-Objekt bei dem Aufruf, einen Zahlungstoken abzurufen.