# 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 Kundenportal 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)
    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.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.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.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 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.

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