# Zahlungsdetails Zeigt Details zu einer bestimmten Zahlung an und ermöglicht es Nutzer/innen, Zahlungsanfechtungen zu verwalten und Rückerstattungen durchzuführen. Diese Komponente ist eine Teilmenge von `payments`, die das Detail-Overlay einer bestimmten Zahlung bereitstellt. Die von der Zahlungsdetails-Komponente gerenderte Nutzeroberfläche entspricht dem Overlay, das von der Komponente `payments` gerendert wird, wenn Nutzerinnen und Nutzer auf eine Zahlungszeile klicken. Verwenden Sie die Komponente `payment-details`, um das Overlay mit Zahlungsdetails aufzurufen, ohne dass Sie die gesamte Liste `payments` in Ihre Website einbinden müssen. Auf diese Weise können Sie das Overlay mit den Zahlungsdetails von Ihrer bestehenden Nutzeroberfläche (z. B. Ihrer Zahlungsliste) aus aufrufen und in unsere Detailansicht integrieren, um Ihren Kundinnen und Kunden die Anzeige von Zahlungsdetails, die Ausstellung von Erstattungen und die Verwaltung angefochtener Zahlungen zu ermöglichen. Standardmäßig bieten die eingebetteten Komponenten begrenzte Informationen für Destination Charges und separate Zahlungen und Überweisungen. Sie bieten keinen Zugriff auf Kundeninformationen, Zahlungsmethoden und bestimmte Zahlungsdetails. Mit der Funktion Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. Aktivieren Sie beim [Erstellen einer Kontositzung](https://docs.stripe.com/api/account_sessions/create.md) die Zahlungsdetails, indem Sie im `components`-Parameter `payment_details` angeben. Sie können einzelne Funktionen der Zahlungsdetails-Komponente aktivieren oder deaktivieren, indem Sie unter `payment_details` den `features`-Parameter festlegen: ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[payment_details][enabled]=true" \ -d "components[payment_details][features][refund_management]=true" \ -d "components[payment_details][features][dispute_management]=true" \ -d "components[payment_details][features][capture_payments]=true" \ -d "components[payment_details][features][destination_on_behalf_of_charge_management]=false" ``` Nachdem die Kontositzung erstellt und [ConnectJS initiiert wurde](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), können Sie die Zahlungsdetails-Komponente im Frontend anzeigen: #### JavaScript ```js // Include this element in your HTML const paymentDetails = stripeConnectInstance.create('payment-details'); paymentDetails.setPayment('{{PAYMENT_INTENT_OR_CHARGE_ID}}'); // use setOnClose to set a callback function to close payment-details paymentDetails.setOnClose(() => { paymentDetails.remove(); }); container.appendChild(paymentDetails); ``` > Für [Destination Charges](https://docs.stripe.com/connect/destination-charges.md) und [separate Zahlungen und Überweisungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md) ist der PaymentIntent auf dem verbundenen Konto nicht vorhanden. Übergeben Sie stattdessen die zugehörige Zahlungs-ID, die zum verbundenen Konto gehört. Die Komponente payment details zeigt verschiedene Informationen und unterstützt verschiedene Funktionen für verschiedene Zahlungstypen: - Bei direkten Abbuchungen können Ihre verbundenen Konten die vollständigen Informationen einsehen. Sie können auch Rückerstattungen und Zahlungsanfechtungen verwalten und Zahlungen erfassen, wenn Sie die entsprechenden Funktionen beim Erstellen einer Kontositzung aktivieren. - Für [Destination Charges](https://docs.stripe.com/connect/destination-charges.md) und [separate Zahlungen und Überweisungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md) können Ihre verbundenen Konten nur das mit der ausgewählten Zahlung verknüpfte Überweisungsobjekt sehen, das nur begrenzte Informationen enthält. - Für Destination Charges mit dem Attribut [on_behalf_of](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-on_behalf_of) können Ihre verbundenen Konten die vollständigen Informationen anzeigen, wenn die Funktion `destination_on_behalf_of_charge_management` aktiviert ist. Wenn diese Funktion aktiviert ist, können Sie auch die Rückerstattungs- und Beilegungsverwaltung aktivieren, indem Sie die entsprechenden Funktionen aktivieren. ### Erlauben Sie Ihren verbundenen Konten, Destination Charges zu verwalten Wenn Sie die Funktion `destination_on_behalf_of_charge_management` auf `true` setzen, können Ihre verbundenen Konten die Zahlungskomponente verwenden, um [Destination Charges](https://docs.stripe.com/connect/destination-charges.md) mit dem Attribut [on_behalf_of](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-on_behalf_of) anzuzeigen und zu verwalten. Wenn Sie auch die Funktion `dispute_management` aktivieren, können sich Ihre verbundenen Konten [direkt an der Bearbeitung ihrer Zahlungsanfechtungen beteiligen](https://docs.stripe.com/connect/supported-embedded-components/payments.md#dispute-management-for-destination-charges). Das Aktivieren der Funktion `destination_on_behalf_of_charge_management` hat die folgenden Einschränkungen: 1. Sie können nicht nach Gebührenstatus oder Zahlungsmethoden filtern. 1. Sie können bestimmte Datenspalten nicht exportieren. ## Verwaltung von Zahlungsanfechtungen für Destination Charges Wenn Sie sowohl `dispute_management` als auch `destination_on_behalf_of_charge_management` aktivieren, können Ihre verbundenen Konten Anfechtungsbeweise aktualisieren und ändern, Anfechtungen entgegenwirken und Zahlungsanfechtungen für Destination Charges mit dem für das verbundene Konto festgelegten Attribut `on_behalf_of` akzeptieren. Für [Destination Charges](https://docs.stripe.com/connect/destination-charges.md), mit oder ohne `on_behalf_of`, bucht Stripe angefochtene Beträge und Gebühren von Ihrem Plattformkonto ab. Wir empfehlen, einen [Webhook](https://docs.stripe.com/webhooks.md) einzurichten, um [durch Zahlungsanfechtungen erstellte Ereignisse](https://docs.stripe.com/api/events/types.md#event_types-charge.dispute.created) zu überwachen. In diesem Fall können Sie versuchen, Gelder von dem verbundenen Konto zurückzuerhalten, indem Sie die Überweisung über das [Dashboard](https://dashboard.stripe.com/test/transfers) oder durch [Erstellen einer Rückbuchung](https://docs.stripe.com/api/transfer_reversals/create.md) rückgängig machen. Wenn das verbundene Konto einen negativen Saldo aufweist, versucht Stripe, [das externe Konto zu belasten](https://docs.stripe.com/connect/account-balances.md#automatically-debit-connected-accounts), wenn `debit_negative_balances` auf `true` festgelegt ist. Wenn Sie der Zahlungsanfechtung widersprechen und gewinnen, können Sie die Gelder, die Sie zuvor zurückgebucht haben, auf das verbundene Konto zurücküberweisen. Wenn Ihre Plattform nicht über ausreichendes Guthaben verfügt, schlägt die Übertragung fehl. Verhindern Sie Fehler aufgrund unzureichendem Guthaben, indem Sie [Gelder auf Ihr Stripe-Guthaben einzahlen](https://docs.stripe.com/get-started/account/add-funds.md). > Die erneute Überweisung einer früheren Rückbuchung unterliegt [Beschränkungen für grenzüberschreitende Überweisungen](https://docs.stripe.com/connect/account-capabilities.md#transfers-cross-border). Das bedeutet, Sie haben möglicherweise keine Möglichkeit, eine Rückzahlung auf Ihr verbundenes Konto durchzuführen. Warten Sie stattdessen damit, angefochtene grenzüberschreitender Zahlungstransfers für Destination Charges mit `on_behalf_of` doch noch als Einnahmen zu buchen, bis eine Zahlungsanfechtung zu Ihren Ungunsten entschieden wurde. ## Unterstützte Parameter Diese eingebettete Komponente unterstützt die folgenden Parameter: #### HTML + JS | Methode | Typ | Beschreibung | | | ------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `setPayment` | `string` | Die ID der Zahlung, Abbuchung oder des PaymentIntent, die im Overlay angezeigt wird. Bei der ID sollte sich um die Zahlungs-ID, Abbuchungs-ID oder PaymentIntent-ID des verbundenen Kontos handeln. Wenn dieses Attribut nicht definiert ist, wird in der eingebetteten Komponente nichts angezeigt. Diese ID erhalten Sie, indem Sie die [Charges API](https://docs.stripe.com/api/charges.md) abfragen oder eine Zahlungs-ID verwenden, die Sie in Ihrer Integration erstellt oder gespeichert haben. | erforderlich | | `setOnClose` | `() => void` | Wir senden dieses Ereignis, wenn der/die Nutzer/in das Overlay schließt. | | Um das Schließverhalten dieser Komponente zu aktivieren, überwachen Sie das Ereignis `close`, indem Sie `setOnClose` aufrufen. #### React | React-Eigenschaft | Typ | Beschreibung | | | ----------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `payment` | `string` | Die ID der Zahlung, Abbuchung oder des PaymentIntent, die im Overlay angezeigt wird. Bei der ID sollte sich um die Zahlungs-ID, Abbuchungs-ID oder PaymentIntent-ID des verbundenen Kontos handeln. Wenn dieser Parameter nicht übergeben wird, wird in der eingebetteten Komponente nichts angezeigt. Diese ID erhalten Sie, indem Sie die [Charges API](https://docs.stripe.com/api/charges.md) abfragen oder eine Zahlungs-ID verwenden, die Sie in Ihrer Integration erstellt oder gespeichert haben. | erforderlich | | `onClose` | `() => void` | Die Funktion, die ausgeführt wird, wenn der Nutzer/die Nutzerin das Overlay schließt. | erforderlich |