Payments

„Payments“ zeigt eine Transaktionsliste für Direct Charges, Destination Charges und separate Zahlungen und Überweisungen für das verbundene Konto an.

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.

Kontositzung erstellen

Aktivieren Sie beim Erstellen einer Kontositzung die eingebettete Zahlungskomponente, indem Sie im components-Parameter payments angeben. Sie können einzelne Funktionen der Zahlungsdetails-Komponente aktivieren oder deaktivieren, indem Sie unter payments den features-Parameter festlegen:

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[payments][enabled]"=true \
  -d "components[payments][features][refund_management]"=true \
  -d "components[payments][features][dispute_management]"=true \
  -d "components[payments][features][capture_payments]"=true \
  -d "components[payments][features][destination_on_behalf_of_charge_management]"=false

Die Komponente payments 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.

Die Zahlungskomponente rendern

Nachdem die Kontositzung erstellt und ConnectJS initialisiert wurde, können Sie die Zahlungskomponente im Frontend anzeigen:

// Include this element in your HTML
const payments = stripeConnectInstance.create('payments');
container.appendChild(payments);

// Optional: specify filters to apply on load
// payments.setDefaultFilters({
//   amount: {greaterThan: 100},
//   date: {before: new Date(2024, 0, 1)},
//   status: ['partially_refunded', 'refund_pending', 'refunded'],
//   paymentMethod: 'card',});

Festlegen von Standardfiltern

Das Festlegen von Standardfiltern für die Zahlungsliste ist optional. Wenn dies festgelegt ist, werden alle gültigen Filter angewendet und ungültige Filter ignoriert. Wenn die Funktion destination_on_behalf_of_charge_management aktiviert ist, können Sie nicht nach Status oder Zahlungsmethode filtern, sodass diese Filter automatisch ignoriert werden.

Mit dem PaymentsListDefaultFilters-Objekt können Sie eine beliebige Kombination von Zahlungsfiltern angeben.

Das PaymentsListDefaultFilters-Objekt

Wenn Sie Standardfilter angeben möchten, übergeben Sie ein PaymentsListDefaultFilters-Objekt an den Setter setDefaultFilters. Das Objekt hat die folgenden Eigenschaften. Alle Eigenschaften sind optional.

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.

Beschreibung anpassen

Wenn Sie die Option destination_on_behalf_of_charge_management verwenden, entsprechen die Zahlungsinformationen (einschließlich der Beschreibung), die für die Zielgebühren mit dem on_behalf_of-Attribut angezeigt werden, der ursprünglich erstellten Zahlung. Um eine nutzerdefinierte Beschreibung in der Zahlungsdetailansicht für Zielgebühren und separate Gebühren und Überweisungen anzuzeigen, wenn diese Funktion deaktiviert ist, gehen Sie wie folgt vor:

Destination Charges

Um die Beschreibung für ein Zahlungsobjekt zu aktualisieren, das die Nutzerinnen und Nutzer Ihrer Plattform sehen können, müssen Sie die Stripe-API verwenden. Dies gilt für Plattformen, die Destination Charges verwenden.

1. Suchen Sie nach dem vorhandenen Transfer-Objekt, das Sie für ein Konto erstellt haben. Suchen Sie dafür nach der neuesten Zahlung, die auf dem PaymentIntent erstellt wurde.
2. Verwenden Sie das Charge-Objekt, um das mit der Zahlung verknüpfte transfer-Objekt zu finden.
3. Finden Sie mithilfe des Transfer-Objekts die destination_payment-ID der Übertragung.
4. Rufen Sie die Update Charge API auf, um die Beschreibung der Zielzahlung mithilfe der destination_payment-ID zu aktualisieren.

curl https://api.stripe.com/v1/charges/
{{PAYMENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d description="My custom description"

Diese Beschreibung wird auf der Zahlung sichtbar, nachdem Sie dieses Feld ausgefüllt haben.

Erfahren Sie mehr darüber, wie Sie Destination Charges auf Ihrer Plattform erstellen.

Separate Zahlungen und Überweisungen

Um die Beschreibung für ein Zahlungsobjekt zu aktualisieren, das die Nutzerinnen und Nutzer Ihrer Plattform sehen können, müssen Sie die Stripe-API verwenden. Dies gilt für Plattformen, die separate Zahlungen und Überweisungen verwenden.

1. Finden Sie mithilfe des Transfer-Objekts die destination_payment-ID der Übertragung.
2. Rufen Sie die Update Charge API auf, um die Beschreibung der Zielzahlung mithilfe der im vorherigen Schritt gefundenen destination_payment-ID zu aktualisieren.

curl https://api.stripe.com/v1/charges/
{{PAYMENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d description="My custom description"

Diese Beschreibung wird auf der Zahlung sichtbar, nachdem Sie dieses Feld ausgefüllt haben.

Erfahren Sie mehr darüber, wie Sie separate Zahlungen und Überweisungen erstellen.