# Erstattung 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 > Webhooks > Testen > Payments > 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. Endpoint: POST refund Version: 1.0 ## Request fields (application/json): - `custom_parameters` (object) Ihre benutzerdefinierten Parameter. - `notification_type` (string, required) Benachrichtigungstyp. - `payment_details` (object, required) Zahlungsdaten (Objekt). - `payment_details.country_wht` (object) Quellensteuer, die in bestimmten Ländern aufgrund grenzüberschreitender Transaktionen anfällt (Objekt). - `payment_details.country_wht.amount` (number) Betrag. - `payment_details.country_wht.currency` (string) Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `payment_details.country_wht.percent` (number) Quellensteuersatz des Landes (in %). - `payment_details.direct_wht` (object) Direkte Quellensteuer. - `payment_details.direct_wht.percent` (number) Direkter Quellensteuersatz. - `payment_details.payment` (object) Vom Benutzer entrichteter Betrag (Objekt). - `payment_details.payment_method_fee` (object) Gebühren des Zahlungssystems. - `payment_details.payment_method_sum` (object) Betrag, der vom Zahlungssystem abgebucht wird. - `payment_details.payout` (object) Details zur Auszahlung (Objekt). - `payment_details.payout_currency_rate` (string) Wechselkurs zwischen Zahlungs- und Auszahlungswährung. - `payment_details.repatriation_commission` (object) Objekt mit Daten über die Rückübertragungskosten, die Xsolla von Dritten auferlegt wurden. - `payment_details.sales_tax` (object) Sales Tax (Objekt; nur in den USA und Kanada). - `payment_details.sales_tax.percent` (number) Sales-Tax-Steuersatz. - `payment_details.user_acquisition_fee` (object) Der Gesamtbetrag der Nutzerakquisitionsgebühren, der für die durch Affiliate-Netzwerke und Influencer vermittelten Käufe abgezogen wird (Objekt). - `payment_details.user_acquisition_fee.percent` (number) Gebührensatz für die Nutzerakquise (in %). - `payment_details.vat` (object) Angaben zur MwSt. (Objekt, nur in der EU). - `payment_details.vat.percent` (number) Mehrwertsteuersatz. - `payment_details.xsolla_balance_sum` (object) Betrag, der vom Xsolla-Konto abgebucht wird. - `payment_details.xsolla_fee` (object) Xsolla-Gebühr (Objekt). - `purchase` (object) Objekt, welches Angaben zum Kauf enthält. - `purchase.checkout` (object) Objekt, welches Angaben zur Bezahlung enthält. - `purchase.checkout.amount` (number) Kaufbetrag. - `purchase.subscription` (object) Angaben zum Abonnement (Objekt). - `purchase.subscription.amount` (number) Preis in echter Währung. - `purchase.subscription.date_create` (string) Datum, an dem das Abonnement abgeschlossen wurde. Datums- und Zeitangabe gemäß [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `purchase.subscription.plan_id` (string) ID des Abo-Modells (extern, falls das Abo-Modell über die API angelegt wurde). - `purchase.subscription.subscription_id` (integer) In der Xsolla-Datenbank erfasste Abonnement-ID. - `purchase.subscription.tags` (array) Abo-Modell-Markierungen. - `purchase.total` (object, required) Gesamtpreis des Einkaufs (Objekt). - `purchase.total.amount` (number) Gesamtbetrag der Zahlung. - `refund_details` (object) Benutzerdaten (Objekt). - `refund_details.author` (string) Erstattungsinitiator. Der Feldwert wird gemäß der Tabelle übermittelt: Erstattungsinitiator Feldwert Spiel (über API). API Kundenportal-Nutzer (automatische Erstattung). E-Mail-Adresse des Nutzers Kundenportal-Nutzer (mit Unterstützung des Xsolla-Kundensupports). support@xsolla.com Xsolla (mit Unterstützung des Xsolla-Kundensupports). support@xsolla.com - `refund_details.code` (integer) Code-ID. - `refund_details.reason` (string) Grund für die Rückerstattung. - `settings` (object) Benutzerdefinierte Projekteinstellungen (Objekt). - `settings.merchant_id` (integer) Händler-ID. - `settings.project_id` (integer) Projekt-ID. Dieser Parameter wird im [Kundenportal](https://publisher.xsolla.com/) neben dem Projektnamen angezeigt. - `transaction` (object, required) Details zur Transaktion (Objekt). - `transaction.agreement` (integer) ID der Vereinbarung. - `transaction.dry_run` (integer) Testtransaktion. Der Parameter hat den Wert 1, wenn es sich um eine Testtransaktion handelt. Er wird nicht gesendet, wenn es sich um eine echte Transaktion handelt. - `transaction.external_id` (string) Externe ID der Transaktion. - `transaction.id` (integer) ID der Transaktion. - `transaction.payment_method_order_id` (string) Zahlungs-ID im Zahlungssystem. - `user` (object) Benutzerdaten (Objekt). - `user.country` (string) Land des Benutzers. Ländercode, bestehend aus 2 Großbuchstaben gemäß [ISO 3166-1 ALPHA-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). - `user.email` (string) E-Mail des Benutzers. - `user.id` (string, required) Benutzer-ID. - `user.ip` (string) Benutzer-IP. - `user.name` (string) Benutzername. - `user.phone` (string) Telefonnummer des Benutzers. - `user.zip` (string) Postleitzahl des Benutzers. ## Response 400 fields (application/json): - `error` (object) - `error.code` (string) - `error.message` (string) ## Response 204 fields ## Response 500 fields