Zahlungsdetails

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 sowie separate Gebühren und Überweisungen. Sie bieten keinen Zugriff auf Kundeninformationen, Zahlungsmethoden und einige Details zu Abbuchungsbeträgen. Die Funktion destination_on_behalf_of_charge_management ermöglicht es einem verbundenen Konto, zusätzliche Informationen zu Destination Charges einzusehen sowie Rückerstattungen durchzuführen und Zahlungsanfechtungen zu bearbeiten.

Aktivieren Sie beim Erstellen einer Kontositzung 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 https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_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, können Sie die Zahlungsdetails-Komponente im Frontend anzeigen:

// 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);

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 und separate Zahlungen und Überweisungen 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 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 mit dem Attribut 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.

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.
2. 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, mit oder ohne on_behalf_of, bucht Stripe angefochtene Beträge und Gebühren von Ihrem Plattformkonto ab.

Wir empfehlen, einen Webhook einzurichten, um durch Zahlungsanfechtungen erstellte Ereignisse zu überwachen. In diesem Fall können Sie versuchen, Gelder von dem verbundenen Konto zurückzuerhalten, indem Sie die Überweisung über das Dashboard oder durch Erstellen einer Rückbuchung rückgängig machen.

Wenn das verbundene Konto einen negativen Saldo aufweist, versucht Stripe, das externe Konto zu belasten, 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.

Unterstützte Parameter

Diese eingebettete Komponente unterstützt die folgenden Parameter: