# Stornierung der Bestellung (mit Zahlungs- und Transaktionsdetails) Xsolla sendet den Webhook order_canceled an die angegebene URL, wenn die Zahlung vom Nutzer, Partner oder automatisch storniert wurde. Der Webhook enthält Informationen über zurückgesandte Artikel, Zahlungsdaten und Details zur stornierten Bestellung. Der Webhook wird nicht gesendet, wenn die Zahlung nicht erfolgreich war, zum Beispiel: * das Zahlungsportal geöffnet wurde, aber der Nutzer die Bestellung nicht bezahlt hat * das Zahlungsportal geöffnet wurde, aber während der Zahlung Fehler auftraten Die empfohlene Verarbeitungszeit für Webhooks beträgt maximal drei Sekunden. Endpoint: POST order-cancellation Version: 1.0 ## Request fields (application/json): - `billing` (object) Transaktions- und Zahlungsdetails. - `billing.notification_type` (string, required) Benachrichtigungstyp. - `billing.payment_details` (object, required) Zahlungsdaten (Objekt). - `billing.payment_details.country_wht` (object) Quellensteuer, die in bestimmten Ländern aufgrund grenzüberschreitender Transaktionen anfällt (Objekt). - `billing.payment_details.country_wht.amount` (number) Betrag. - `billing.payment_details.country_wht.currency` (string) Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `billing.payment_details.country_wht.percent` (number) Quellensteuersatz des Landes (in %). - `billing.payment_details.direct_wht` (object) Direkte Quellensteuer. - `billing.payment_details.direct_wht.percent` (number) Direkter Quellensteuersatz. - `billing.payment_details.payment` (object) Vom Benutzer entrichteter Betrag (Objekt). - `billing.payment_details.payment_method_fee` (object) Gebühren des Zahlungssystems. - `billing.payment_details.payment_method_sum` (object) Betrag, der vom Zahlungssystem abgebucht wird. - `billing.payment_details.payout` (object) Details zur Auszahlung (Objekt). - `billing.payment_details.payout_currency_rate` (string) Wechselkurs zwischen Zahlungs- und Auszahlungswährung. - `billing.payment_details.repatriation_commission` (object) Objekt mit Daten über die Rückübertragungskosten, die Xsolla von Dritten auferlegt wurden. - `billing.payment_details.sales_tax` (object) Sales Tax (Objekt; nur in den USA und Kanada). - `billing.payment_details.sales_tax.percent` (number) Sales-Tax-Steuersatz. - `billing.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). - `billing.payment_details.user_acquisition_fee.percent` (number) Gebührensatz für die Nutzerakquise (in %). - `billing.payment_details.vat` (object) Angaben zur MwSt. (Objekt, nur in der EU). - `billing.payment_details.vat.percent` (number) Mehrwertsteuersatz. - `billing.payment_details.xsolla_balance_sum` (object) Betrag, der vom Xsolla-Konto abgebucht wird. - `billing.payment_details.xsolla_fee` (object) Xsolla-Gebühr (Objekt). - `billing.purchase` (object) Objekt, welches Angaben zum Kauf enthält. - `billing.purchase.subscription` (object) Angaben zum Abonnement (Objekt). - `billing.purchase.subscription.amount` (number) Preis in echter Währung. - `billing.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). - `billing.purchase.subscription.plan_id` (string) ID des Abo-Modells (extern, falls das Abo-Modell über die API angelegt wurde). - `billing.purchase.subscription.subscription_id` (integer) In der Xsolla-Datenbank erfasste Abonnement-ID. - `billing.purchase.subscription.tags` (array) Abo-Modell-Markierungen. - `billing.purchase.total` (object, required) Gesamtpreis des Einkaufs (Objekt). - `billing.purchase.total.amount` (number) Gesamtbetrag der Zahlung. - `billing.refund_details` (object) Benutzerdaten (Objekt). - `billing.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 - `billing.refund_details.code` (integer) Code-ID. - `billing.refund_details.reason` (string) Grund für die Rückerstattung. - `billing.settings` (object) Benutzerdefinierte Projekteinstellungen (Objekt). - `billing.settings.merchant_id` (integer) Händler-ID. - `billing.settings.project_id` (integer) Projekt-ID. Dieser Parameter wird im [Kundenportal](https://publisher.xsolla.com/) neben dem Projektnamen angezeigt. - `billing.transaction` (object, required) Details zur Transaktion (Objekt). - `billing.transaction.agreement` (integer) ID der Vereinbarung. - `billing.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. - `billing.transaction.external_id` (string) Externe ID der Transaktion. - `billing.transaction.id` (integer) ID der Transaktion. - `billing.transaction.payment_method_order_id` (string) Zahlungs-ID im Zahlungssystem. - `custom_parameters` (object) Zusätzliche Informationen. - `items` (array, required) Liste der vom Nutzer gekauften Artikel. Die im Array enthaltenen Parameter hängen von der Webhook-Version ab. In Version 2 sind zusätzliche Parameter enthalten: is_free, is_bonus und is_bundle_content. Geben Sie die entsprechende Nummer im Parameter version im API-Aufruf [Informationen zu Webhook-Einstellungen aktualisieren](/de/api/igs/operation/update-webhook/) an, um die Version zu wechseln. - `order` (object, required) Bestellinformationen. - `order.amount` (string, required) Die Gesamtkosten eines Warenkorbs basierend auf der gewählten Währung. - `order.comment` (string,null, required) Benutzeranmerkung der Bestellung. - `order.coupons` (array) Angewandte Gutscheine. Wird der Gutschein nicht angewendet, wird kein Array zurückgegeben. - `order.coupons.code` (string) Der Code eines angewandten Gutscheins. - `order.coupons.external_id` (string) Externe ID. - `order.currency` (string, required) 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. - `order.currency_type` (string, required) Zahlungswährungstyp. Bei einer kostenlosen Bestellung ist unknown als Wert angegeben. Enum: "real", "virtual", "unknown", "loyalty_point" - `order.id` (integer, required) Eindeutige Kennung der Bestellung des Benutzers aufseiten von Xsolla. - `order.invoice_id` (string,null, required) Rechnungs-ID bei Zahlungen mit echter Währung. Bei Zahlungen mit virtueller Währung oder bei kostenlosen Artikeln wird der Wert null genutzt. - `order.mode` (string, required) Zahlungsmodus. default wird bei realen Zahlungen verwendet; sandbox bei Testzahlungen. Enum: "default", "sandbox" - `order.platform` (string,null, required) 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" - `order.promocodes` (array) Angewandte Promocodes. Wird der Promocode nicht angewandt, wird kein Array zurückgegeben. - `order.promocodes.code` (string) Der Code eines angewandten Promocodes. - `order.promotions` (array, required) Angewandte Werbeaktionen für die gesamte Bestellung. Das Array wird in den folgenden Fällen zurückgegeben: - Eine Werbeaktion wirkt sich auf den Gesamtkaufbetrag aus, z. B. ein Aktionscode mit der Einstellung Rabatt auf Kauf. - Es wird kein Rabatt auf den Kauf angewandt, aber es werden Bonusartikel der Bestellung hinzugefügt. In diesem Fall werden die Werte für den Preis mit ([amount_with_discount](/de/webhooks/#operation/order-cancellation!path=order/promotions/amount_with_discount&t=request)) und ohne Rabatt ([amount_without_discount](/de/webhooks/#operation/order-cancellation!path=order/promotions/amount_without_discount&t=request)) zurückgegeben, wobei beide Werte identisch sind, da kein Rabatt angewandt wird. Werden keine Werbeaktionen auf Bestellebene angewandt, wird ein leeres Array zurückgegeben. - `order.promotions.amount_with_discount` (string) Gesamtkosten der Gegenstände inklusive Rabatt. - `order.promotions.amount_without_discount` (string) Gesamtkosten der Gegenstände ohne Rabatt. - `order.promotions.sequence` (integer) Reihenfolge der angewandten Werbeaktionen. - `order.status` (string, required) Bestellstatus. - `user` (object, required) Benutzerinformationen. - `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, required) E-Mail-Adresse des Benutzers. - `user.external_id` (string, required) Benutzer-ID. ## Response 200 fields ## Response 400 fields