# Zahlung Wenn ein Nutzer eine Zahlung abschließt, sendet Xsolla die Zahlungsdetails in einem Webhook vom Typ payment an die Webhook-URL. Die erwarteten Antwortcodes sind im Abschnitt Responses beschrieben, Sie können jedoch auch andere Antwortcodes verwenden: Antwortcode Beschreibung 200, 201, 204 Eine erfolgreiche Antwort. 4xx Ein Fehler ist aufgetreten. Beispielsweise wurde der angegebene Nutzer nicht gefunden oder eine ungültige Signatur wurde übermittelt. 5xx Ein temporärer Serverfehler. Bei einer solchen Antwort versucht Xsolla automatisch, den Webhook erneut zu senden. Dabei verlängert sich das Intervall zwischen den Versuchen schrittweise, bis Ihr Listener den Empfang bestätigt. Es werden maximal 12 Versuche innerhalb eines Zeitraums von 48 Stunden unternommen. Wenn Sie die Webhook-URL im Kundenporta l speichern, können Sie auch den Empfang zusätzlicher Informationen in Webhooks einrichten. Hinweis Wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter in Ihre Projekt unter Einstellungen > Webhooks > Testen > Payments > Erweiterte Einstellungen. Schalter Beschreibung Infos über das gespeicherte Zahlungskonto anzeigen Informationen über die gespeicherte Zahlungsmethode werden in dem benutzerdefinierten Objekt payment_account übermittelt. 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 verwendet1 – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert2 – die zuvor gespeicherte Zahlungsmethode wird verwendetpayment_type:1 – Einmalzahlung2 – wiederkehrende Zahlung Bestellobjekt dem Webhook hinzufügen Die Informationen über die Bestellung werden im order-Objekt des Zahlung-Webhooks übermittelt. Nur notwendige Nutzerparameter ohne vertrauliche Daten senden Im Webhook werden nur die folgenden Nutzerinformationen übermittelt:IDLand BLZ und Endziffern von Karten anzeigen Im Webhook werden nur die folgenden Informationen über die Bankkartennummer übermittelt:die ersten sechs Ziffern im Parameter card_bindie letzten vier Ziffern im Parameter card_suffix Kartenmarke anzeigen Die Marke der Karte, mit der die Zahlung getätigt wurde. Zum Beispiel: Mastercard oder Visa. Hinweis Die in einem Webhook versendeten Felder hängen von Folgendem ab:den erweiterten Einstellungen im Kundenportalden bei Xsolla konfigurierten benutzerdefinierten EinstellungenBei Fragen wenden Sie sich bitte an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com. Endpoint: POST payment Version: 1.0 ## Request fields (application/json): - `custom_parameters` (object) Ihre benutzerdefinierten Parameter. - `notification_type` (string, required) Benachrichtigungstyp. - `payment_details` (object, required) Zahlungsdaten (Objekt). - `payment_details.country_wht` (object) Quellensteuer, die in bestimmten Ländern aufgrund grenzüberschreitender Transaktionen anfällt (Objekt). - `payment_details.country_wht.amount` (number) Betrag. - `payment_details.country_wht.currency` (string) Währung. Währungscode, bestehend aus drei Buchstaben gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `payment_details.country_wht.percent` (number) Quellensteuersatz des Landes (in %). - `payment_details.direct_wht` (object) Direkte Quellensteuer. - `payment_details.direct_wht.percent` (number) Direkter Quellensteuersatz. - `payment_details.payment` (object) Vom Benutzer entrichteter Betrag (Objekt). - `payment_details.payment_method_fee` (object) Gebühren des Zahlungssystems. - `payment_details.payment_method_sum` (object) Betrag, der vom Zahlungssystem abgebucht wird. - `payment_details.payout` (object) Details zur Auszahlung (Objekt). - `payment_details.payout_currency_rate` (string) Wechselkurs zwischen Zahlungs- und Auszahlungswährung. - `payment_details.repatriation_commission` (object) Objekt mit Daten über die Rückübertragungskosten, die Xsolla von Dritten auferlegt wurden. - `payment_details.sales_tax` (object) Sales Tax (Objekt; nur in den USA und Kanada). - `payment_details.sales_tax.percent` (number) Sales-Tax-Steuersatz. - `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). - `payment_details.user_acquisition_fee.percent` (number) Gebührensatz für die Nutzerakquise (in %). - `payment_details.vat` (object) Angaben zur MwSt. (Objekt, nur in der EU). - `payment_details.vat.percent` (number) Mehrwertsteuersatz. - `payment_details.xsolla_balance_sum` (object) Betrag, der vom Xsolla-Konto abgebucht wird. - `payment_details.xsolla_fee` (object) Xsolla-Gebühr (Objekt). - `purchase` (object) Objekt, welches Angaben zum Kauf enthält. - `purchase.checkout` (object) Objekt, welches Angaben zur Bezahlung enthält. - `purchase.checkout.amount` (number) Kaufbetrag. - `purchase.coupon` (object) Angaben zum Gutschein (Objekt; falls ein Gutschein bei Abschluss des Abonnements genutzt wurde). - `purchase.coupon.campaign_code` (string) Kampagne. - `purchase.coupon.coupon_code` (string) Gutscheincode. - `purchase.gift` (object) Benutzerdaten (Objekt). - `purchase.gift.giver_id` (string) Spender-ID. - `purchase.gift.hide_giver_from_receiver` (string) Legt fest, ob die Identität des Spenders vor dem Beschenkten geheim gehalten werden soll. - `purchase.gift.message` (string) Nachricht vom Spender. - `purchase.gift.receiver_email` (string) E-Mail des Geschenkempfängers. - `purchase.gift.receiver_id` (string) ID des Geschenkempfängers. - `purchase.order` (object) Objekt mit Informationen über eine Bestellung. Wenn Sie diese Informationen erhalten möchten, stellen Sie den Schalter Bestellobjekt dem Webhook hinzufügen im [Kundenportal](https://publisher.xsolla.com/) unter Projekteinstellungen > Webhooks > Erweiterte Einstellungen auf Ein. - `purchase.order.id` (integer) Bestell-ID. - `purchase.order.lineitems` (array) Array von Parametern, die Informationen über Gegenstände enthalten. - `purchase.order.lineitems.price` (object) Objekt mit Informationen über einen Artikelpreis. - `purchase.order.lineitems.price.amount` (number) Gesamtpreis des Artikels in der ausgewählten Währung. - `purchase.order.lineitems.price.currency` (string) Währung des Artikelpreises. - `purchase.order.lineitems.quantity` (integer) Artikelmenge. - `purchase.order.lineitems.sku` (string) Artikel-SKU. - `purchase.promotions` (array) Werbeaktionen, die bei dieser Transaktion Verwendung finden. - `purchase.promotions.id` (integer) ID der Werbeaktion. - `purchase.promotions.technical_name` (string) Arbeitstitel der Werbeaktion. - `purchase.subscription` (object) Angaben zum Abonnement (Objekt). - `purchase.subscription.amount` (number) Preis in echter Währung. - `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). - `purchase.subscription.date_next_charge` (string) Nächstes Rechnungsdatum. Datums- und Zeitangabe gemäß [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `purchase.subscription.plan_id` (string) ID des Abo-Modells (extern, falls das Abo-Modell über die API angelegt wurde). - `purchase.subscription.product_id` (string) Produkt-ID (falls sie im Zugriffstoken versendet wurde). - `purchase.subscription.subscription_id` (integer) In der Xsolla-Datenbank erfasste Abonnement-ID. - `purchase.subscription.tags` (array) Abo-Modell-Markierungen. - `purchase.total` (object, required) Gesamtpreis des Einkaufs (Objekt). - `purchase.total.amount` (number) Gesamtbetrag der Zahlung. - `settings` (object) Benutzerdefinierte Projekteinstellungen (Objekt). - `settings.merchant_id` (integer) Händler-ID. - `settings.project_id` (integer) Projekt-ID. Dieser Parameter wird im [Kundenportal](https://publisher.xsolla.com/) neben dem Projektnamen angezeigt. - `transaction` (object, required) Details zur Transaktion (Objekt). - `transaction.agreement` (integer) ID der Vereinbarung. - `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. - `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). - `transaction.id` (integer) ID der Transaktion. - `transaction.payment_date` (string) Zahlungsdatum. - `transaction.payment_method` (integer) ID der Zahlungsart. - `transaction.payment_method_name` (string) Name der Zahlungsmethode. - `transaction.payment_method_order_id` (string) Zahlungs-ID im Zahlungssystem. - `user` (object) Benutzerdaten (Objekt). - `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) E-Mail des Benutzers. - `user.id` (string, required) Benutzer-ID. - `user.ip` (string) Benutzer-IP. - `user.name` (string) Benutzername. - `user.phone` (string) Telefonnummer des Benutzers. - `user.zip` (string) Postleitzahl des Benutzers. ## Response 400 fields (application/json): - `error` (object) - `error.code` (string) - `error.message` (string) ## Response 204 fields ## Response 500 fields