# Erfolgreiche Bezahlung der Bestellung (mit Zahlungs- und Transaktionsdetails)

Xsolla sendet den Webhook order_paid an die angegebene URL, wenn 
der Nutzer die Bestellung erfolgreich bezahlt hat.

Der Webhook order_paid enthält Informationen zu den gekauften 
Artikeln, Zahlungsdaten und Transaktionsdetails.

Der Webhook order_paid wird nicht gesendet, wenn die Zahlung nicht 
erfolgreich war, zum Beispiel:
* die Zahlungsmaske geöffnet wurde, aber der Benutzer die Bestellung nicht 
  bezahlt hat
* die Zahlungsmaske geöffnet wurde, aber während der Zahlung Fehler auftraten

Es wird empfohlen, den Webhook order_paid in weniger als drei 
Sekunden zu verarbeiten.


Hinweis
Die in einem Webhook versendeten Felder hängen von den folgenden Einstellungen ab:den im Konto unter Projekteinstellungen > Webhooks > Erweiterte Einstellungen konfigurierten Einstellungenden bei Xsolla konfigurierten EinstellungenBei Fragen wenden Sie sich bitte an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.


Die erwarteten Antworten sind im Abschnitt Antworten beschrieben. Sie 
können andere Antwortcodes verwenden. Abhängig vom Antwortcode und je nachdem, 
ob die automatische Zahlungserstattung aktiviert ist oder nicht, sieht die 
Webhook-Verarbeitungslogik aufseiten von Xsolla wie folgt aus:


    
    
        Antwortcode
        Automatische Zahlungserstattung ist deaktiviert (standardmäßig)
        Automatische Zahlungserstattung ist aktiviert
    
    
    
    
        400, 401, 402, 403, 404, 409, 422, 415
        Keine Aktionen
        Benutzer erhält automatische eine Erstattung
    
    
        200, 201, 204
        Keine Aktionen
        Keine Aktionen
    
    
        Anderer Code oder keine Antwort auf Webhook
        Mehrere Webhooks werden innerhalb eines bestimmten Zeitintervalls gesendet: Zwei Versuche im Abstand von 5 Minuten, sieben Versuche im Abstand von jeweils 15 Minuten, zehn Versuche im Abstand von jeweils 60 Minuten.
        Mehrere Webhooks werden innerhalb eines bestimmten Zeitintervalls gesendet: Zwei Versuche im Abstand von 5 Minuten, sieben Versuche im Abstand von jeweils 15 Minuten, zehn Versuche im Abstand von jeweils 60 Minuten. Wurden alle Webhooks gesendet, ohne eine erfolgreiche Antwort erhalten zu haben, wird dem Benutzer automatisch eine Erstattung ausgestellt.
    
    


Wenden Sie sich an Ihre Customer Success Manager oder senden Sie eine E-Mail an 
csm@xsolla.com, um die automatische Erstattungsfunktion zu verknüpfen.

Endpoint: POST successful-order-payment
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)
    Objekt mit Daten zu Quellensteuern, die in bestimmten Ländern aufgrund grenzüberschreitender Transaktionen erhoben werden.

  - `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)
    Prozentsatz des Quellensteuersatzes.

  - `billing.payment_details.direct_wht` (object)
    Direkte Quellensteuer.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `billing.purchase` (object)
    Objekt, welches Angaben zum Kauf enthält.

  - `billing.purchase.coupon` (object)
    Angaben zum Gutschein (Objekt; falls ein Gutschein bei Abschluss des Abonnements genutzt wurde).

  - `billing.purchase.coupon.campaign_code` (string)
    Kampagne.

  - `billing.purchase.coupon.coupon_code` (string)
    Gutscheincode.

  - `billing.purchase.gift` (object)
    Benutzerdaten (Objekt).

  - `billing.purchase.gift.giver_id` (string)
    Spender-ID.

  - `billing.purchase.gift.hide_giver_from_receiver` (string)
    Legt fest, ob die Identität des Spenders vor dem Beschenkten geheim gehalten werden soll.

  - `billing.purchase.gift.message` (string)
    Nachricht vom Spender.

  - `billing.purchase.gift.receiver_email` (string)
    E-Mail des Geschenkempfängers.

  - `billing.purchase.gift.receiver_id` (string)
    ID des Geschenkempfängers.

  - `billing.purchase.promotions` (array)
    Werbeaktionen, die bei dieser Transaktion Verwendung finden.

  - `billing.purchase.promotions.id` (integer)
    ID der Werbeaktion.

  - `billing.purchase.promotions.technical_name` (string)
    Arbeitstitel der Werbeaktion.

  - `billing.purchase.subscription` (object)
    Angaben zum Abonnement (Objekt).

  - `billing.purchase.subscription.amount` (number)
    Preis in echter Währung.

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

  - `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.date_next_charge` (string)
    Nächstes Rechnungsdatum. 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.product_id` (string)
    Produkt-ID (falls sie im Zugriffstoken versendet 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.purchase.total.currency` (string)
    Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `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 [Konto](/de/webhooks/overview/#business-accounts) 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 Transaktions-ID. Ausführliche Informationen finden Sie in den [FAQs](/de/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id).

  - `billing.transaction.id` (integer)
    ID der Transaktion.

  - `billing.transaction.payment_date` (string)
    Zahlungsdatum.

  - `billing.transaction.payment_method` (integer)
    ID der Zahlungsart.

  - `billing.transaction.payment_method_name` (string)
    Name der Zahlungsmethode.

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

The set of parameters included in the array depends on the webhook version. 
Version 2 includes additional parameters: is_free, is_bonus, and 
is_bundle_content. To switch the version, pass its number in the version 
parameter in the [Update webhook version](/de/api/catalog/common-webhooks/update-webhook-version/) API call.

  - `notification_type` (string, required)
    Benachrichtigungstyp.

  - `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 über Xsolla abgewickelten Zahlungen wird der Wert xsolla verwendet. Bei anderen Zahlungen wird als Wert der Name der entsprechenden Publishing-Plattform verwendet.
    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.promocodes.external_id` (string)
    Externe ID.

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