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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_OR_PAYMENT_INTENT_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

For destination charges, with or without on_behalf_of, Stripe debits dispute amounts and fees from your platform account.

We recommend setting up a webhook to listen to dispute created events. When that happens, you can attempt to recover funds from the connected account by reversing the transfer through the Dashboard or by creating a transfer reversal.

If the connected account has a negative balance, Stripe attempts to debit its external account if debit_negative_balances is set to true.

If you challenge the dispute and win, you can transfer the funds that you previously reversed back to the connected account. If your platform has an insufficient balance, the transfer fails. Prevent insufficient balance errors by adding funds to your Stripe balance.

When both dispute_management and destination_on_behalf_of_charge_management are enabled, the connected accounts can update and modify dispute evidence, counter disputes, and accept disputes for destination charges with the on_behalf_of attribute set to the connected account.

Unterstützte Parameter

Diese eingebettete Komponente unterstützt die folgenden Parameter: