Erstattung

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.

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

Art der Benachrichtigung.

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	integer <float> Betrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.
percent	integer <float> Direkter Quellensteuersatz.

object

Vom Benutzer entrichteter Betrag (Objekt).

amount	integer <float> Betrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Gebühren des Zahlungssystems.

amount	integer <float> Betrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Betrag, der vom Zahlungssystem abgebucht wird.

amount	integer <float> Betrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Details zur Auszahlung (Objekt).

amount	integer <float> Betrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

payout_currency_rate

integer <float>

Wechselkurs zwischen Zahlungs- und Auszahlungswährung.

object

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

amount	integer <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	integer <float> Betrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.
percent	integer <float> Sales-Tax-Steuersatz.

object

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

amount	integer <float> Betrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.
percent	integer <float> Mehrwertsteuersatz.

object

Betrag, der vom Xsolla-Konto abgebucht wird.

amount	integer <float> Betrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Xsolla-Gebühr (Objekt).

amount	integer <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	integer <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	integer <float> Kaufbetrag.
currency	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Angaben zum Abonnement (Objekt).

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

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 Xsolla-ID des Spiels. Kann im Kundenportal eingesehen werden.

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
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-d '{
        "notification_type": "refund",
        "settings": {
          "project_id": 18404,
          "merchant_id": 2340
        },
        "purchase": {
            "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
            },
            "total":{
                "currency": "USD",
                "amount": 200
            }
        },
        "user": {
            "ip": "127.0.0.1",
            "phone": "18777976552",
            "email": "email@example.com",
            "id": "1234567",
            "name": "John Smith",
            "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": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}