# Teilerstattung

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 > Webhooks > 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 > 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.
    
    
        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
        Die Zahlung wurde abgelehnt, da das Zahlungssystem einen möglichen Betrugsversuch festgestellt hat.Empfehlung: Setzen Sie den Nutzer auf die Sperrliste.
    
    
        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.

Endpoint: POST partial-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.direct_wht` (object)
    Direkte Quellensteuer.

  - `payment_details.direct_wht.amount` (number)
    Betrag.

  - `payment_details.direct_wht.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.direct_wht.percent` (number)
    Direkter Quellensteuersatz.

  - `payment_details.payment` (object)
    Vom Benutzer entrichteter Betrag (Objekt).

  - `payment_details.payment.amount` (number)
    Betrag.

  - `payment_details.payment.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payment_method_fee` (object)
    Gebühren des Zahlungssystems.

  - `payment_details.payment_method_fee.amount` (number)
    Betrag.

  - `payment_details.payment_method_fee.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payment_method_sum` (object)
    Betrag, der vom Zahlungssystem abgebucht wird.

  - `payment_details.payment_method_sum.amount` (number)
    Betrag.

  - `payment_details.payment_method_sum.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payout` (object)
    Details zur Auszahlung (Objekt).

  - `payment_details.payout.amount` (number)
    Betrag.

  - `payment_details.payout.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `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.repatriation_commission.amount` (number)
    Betrag.

  - `payment_details.repatriation_commission.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.sales_tax` (object)
    Sales Tax (Objekt; nur in den USA und Kanada).

  - `payment_details.sales_tax.amount` (number)
    Betrag.

  - `payment_details.sales_tax.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.sales_tax.percent` (number)
    Sales-Tax-Steuersatz.

  - `payment_details.vat` (object)
    Angaben zur MwSt. (Objekt, nur in der EU).

  - `payment_details.vat.amount` (number)
    Betrag.

  - `payment_details.vat.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.vat.percent` (number)
    Mehrwertsteuersatz.

  - `payment_details.xsolla_balance_sum` (object)
    Betrag, der vom Xsolla-Konto abgebucht wird.

  - `payment_details.xsolla_balance_sum.amount` (number)
    Betrag.

  - `payment_details.xsolla_balance_sum.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.xsolla_fee` (object)
    Xsolla-Gebühr (Objekt).

  - `payment_details.xsolla_fee.amount` (number)
    Betrag.

  - `payment_details.xsolla_fee.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `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.checkout.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase.total` (object, required)
    Gesamtpreis des Einkaufs (Objekt).

  - `purchase.total.amount` (number)
    Zahlungsbetrag der Teilerstattung.

  - `purchase.total.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `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.date` (string)
    Datum der Erstattung.

  - `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.date` (string)
    Transaktionsdatum.

  - `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.

  - `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