Xsolla-logoXsolla Developers
oder
Zum Kundenportal

ErstattungWebhook POST

Wird eine Zahlung storniert, sendet Xsolla die Details der stornierten Transaktion in einem Webhook vom Typ refund an die Webhook-URL. Weitere Informationen zu Erstattungen finden Sie in dieser Anleitung.

Wurde eine Antwort mit dem Code 5xx Code empfangen, sendet Xsolla weitere Webhooks in längeren Zeitabständen, bis Ihr Listener den Empfang bestätigt. Maximal sind 12 Versuche möglich.

Hinweis

Wenn Xsolla eine Erstattung veranlasst und der Webhook mit dem Code 5xx antwortet, wird die Zahlung trotzdem erstattet.

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 verwendet
    • 1 – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert
    • 2 – die zuvor gespeicherte Zahlungsmethode wird verwendet
  • payment_type:
    • 1 – Einmalzahlung
    • 2 – 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.
Request
Request Body schema: application/json
notification_type
required
string

Benachrichtigungstyp.

required
object

Details zur Transaktion (Objekt).

agreement
integer

ID der Vereinbarung.

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.

external_id
string

Externe ID der Transaktion.

id
integer

ID der Transaktion.

payment_method_order_id
string

Zahlungs-ID im Zahlungssystem.

required
object

Zahlungsdaten (Objekt).

object

Direkte Quellensteuer.

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

percent
number <float>

Direkter Quellensteuersatz.

object

Vom Benutzer entrichteter Betrag (Objekt).

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Gebühren des Zahlungssystems.

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Betrag, der vom Zahlungssystem abgebucht wird.

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Details zur Auszahlung (Objekt).

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

payout_currency_rate
string

Wechselkurs zwischen Zahlungs- und Auszahlungswährung.

object

Objekt mit Daten über die Rückübertragungskosten, die Xsolla von Dritten auferlegt wurden.

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Sales Tax (Objekt; nur in den USA und Kanada).

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

percent
number <float>

Sales-Tax-Steuersatz.

object

Angaben zur MwSt. (Objekt, nur in der EU).

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

percent
number <float>

Mehrwertsteuersatz.

object

Betrag, der vom Xsolla-Konto abgebucht wird.

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Xsolla-Gebühr (Objekt).

amount
number <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

custom_parameters
object

Ihre benutzerdefinierten Parameter.

object

Objekt, welches Angaben zum Kauf enthält.

required
object

Gesamtpreis des Einkaufs (Objekt).

amount
number <float>

Gesamtbetrag der Zahlung.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Objekt, welches Angaben zur Bezahlung enthält.

amount
number <float>

Kaufbetrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object
Deprecated

Spielschlüssel (Array).

object

Objekt mit Upgrade-Daten.

amount
number <float>
Deprecated

Preis in echter Währung.

currency
string
Deprecated

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object
Deprecated

Objekt mit Daten über das Paket, von dem aus der Benutzer ein Upgrade durchgeführt hat.

DRM
string
Deprecated

DRM-Plattform des Spiels.

digital_content
string
Deprecated

Im Kundenportal festgelegte Spiel-SKU.

object
Deprecated

Objekt mit Daten über das Paket, auf das der Benutzer ein Upgrade durchgeführt hat.

DRM
string
Deprecated

DRM-Plattform des Spiels.

digital_content
string
Deprecated

Im Kundenportal festgelegte Spiel-SKU.

object

Angaben zum Abonnement (Objekt).

amount
number <float>

Preis in echter Währung.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

date_create
string

Datum, an dem das Abonnement abgeschlossen wurde. Datums- und Zeitangabe gemäß ISO 8601.

plan_id
string

ID des Abo-Modells (extern, falls das Abo-Modell über die API angelegt wurde).

subscription_id
integer

In der Xsolla-Datenbank erfasste Abonnement-ID.

tags
Array of strings

Abo-Modell-Markierungen.

object
Deprecated

Zu erwerbende virtuelle Währung (Objekt).

amount
number <float>
Deprecated

Preis in echter Währung.

currency
string
Deprecated

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

name
string
Deprecated

Name der virtuellen Währung.

quantity
number <float>
Deprecated

Menge.

object
Deprecated

Die beim Kauf erworbenen virtuellen Gegenstände (Objekt).

amount
number <float>
Deprecated

Kaufbetrag.

currency
string
Deprecated

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

Array of objects
Deprecated
Array
amount
number <float>
Deprecated

Artikelmenge.

sku
string
Deprecated

Artikel-ID.

object

Benutzerdaten (Objekt).

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
code
integer

Code-ID.

reason
string

Grund für die Rückerstattung.

object

Benutzerdefinierte Projekteinstellungen (Objekt).

merchant_id
integer

Händler-ID.

project_id
integer

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

object

Benutzerdaten (Objekt).

id
required
string

Benutzer-ID.

country
string

Land des Benutzers. Ländercode, bestehend aus 2 Großbuchstaben gemäß ISO 3166-1 ALPHA-2.

email
string

E-Mail des Benutzers.

ip
string

Benutzer-IP.

name
string

Benutzername.

phone
string

Telefonnummer des Benutzers.

zip
string

Postleitzahl des Benutzers.

Responses
204

Zur Signalisierung einer erfolgreiche Verarbeitung.

400

Im Falle eines Fehlers in den bereitgestellten Daten (z. B. fehlender erforderlicher Parameter, fehlgeschlagene Autorisierung usw.).

500

Im Falle von temporären Fehlern mit Ihren Servern.

Request samples 
curl -v 'https://your.hostname/your/uri' \
-X POST \
-d '{
        "notification_type": "refund",
        "settings": {
          "project_id": 18404,
          "merchant_id": 2340
        },
        "purchase": {
            "virtual_currency": {
                "name": "Coins",
                "quantity": 10,
                "currency": "USD",
                "amount": 100
            },
            "subscription": {
                "plan_id": "b5dac9c8",
                "subscription_id": "10",
                "date_create": "2014-09-22T19:25:25+04:00",
                "currency": "USD",
                "amount": 9.99
            },
            "checkout": {
                "currency": "USD",
                "amount": 50
            },
            "virtual_items": {
                "items": [
                    {
                        "sku": "com.xsolla.item1",
                        "amount": 1
                    }
                ],
                "currency": "USD",
                "amount": 50
            },
            "total":{
                "currency": "USD",
                "amount": 200
            }
        },
        "user": {
            "ip": "127.0.0.1",
            "phone": "18777976552",
            "email": "email@example.com",
            "id": "1234567",
            "name": "Xsolla User",
            "country": "US"
        },
        "transaction": {
            "id": 1,
            "external_id": 1,
            "dry_run": 1,
            "agreement": 1
        },
        "refund_details": {
            "code": 4,
            "reason": "Potential fraud"
        },
        "payment_details": {
            "sales_tax": {
                "currency": "USD",
                "amount": 0
            },
            "direct_wht": {
                "currency": "USD",
                "amount": 0.70
            },
            "xsolla_fee": {
                "currency": "USD",
                "amount": "10"
            },
            "payout": {
                "currency": "USD",
                "amount": "200"
            },
            "payment_method_fee": {
                "currency": "USD",
                "amount": "20"
            },
            "payment": {
                "currency": "USD",
                "amount": "230"
            },
            "repatriation_commission": {
                "currency": "USD",
                "amount": 10
            }
        }
    }
}'
Response samples
application/json
{
  • "error": {
    }
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2025 Xsolla Inc.