Stripe Connect und die Charges API
Legacy API
Der Inhalt dieses Abschnitts bezieht sich auf eine Legacy-Funktion. Verwenden Sie stattdessen die PaymentIntents API.
Die Charges API unterstützt die folgenden Funktionen nicht, von denen viele für die Einhaltung von Kreditkartenvorschriften erforderlich sind:
Erfahren Sie, wie Sie mit Connect Zahlungen erstellen und Überweisungen für verbundene Konten auslösen können. Die Stripe-Gebühren werden dadurch bestimmt, wie Sie diese Optionen konfigurieren.
Connect unterstützt drei Optionen zur Erstellung von Zahlungen für ein verbundenes Konto. Weitere Informationen zu den verschiedenen Gebühren mit Connect finden Sie in der Dokumentation zur Auswahl des Gebührenansatzes. Die Stripe-Gebühren werden dadurch bestimmt, wie Sie diese Optionen konfigurieren.
Auf dieser Seite wird nur erläutert, wie die Charges API für verbundene Konten aufgerufen wird. Weitere Informationen über Aufrufe an andere APIs für ähnliche Aktionen finden Sie auf den verlinkten Seiten.
Direct Charges
Um eine Direct Charge für das verbundene Konto zu erstellen, erstellen Sie zunächst ein Charge-Objekt und fügen Sie dann die Kopfzeile Stripe-Account
mit einem Wert der ID des verbundenen Kontos ein:
In diesem Beispiel wird das Test-Token tok_visa verwendet; stattdessen können Sie aber auch mit Stripe.js und Elements eine Testkarte tokenisieren.
Weitere Informationen finden Sie unter Zahlung annehmen.
Plattformgebühren für Direct Charges erheben
Mit Connect können Sie für Direct Charges eine Plattformgebühr erheben. Um eine Plattformgebühr festzusetzen, übergeben Sie einen optionalen Wert für application_fee_amount
als positive Ganzzahl:
Informationen zur Verfügbarkeit von Überweisungen, Rückerstattungen und mehr finden Sie unter Direct Charges.
Destination Charges
Um eine Destination Charge zu erstellen, übergeben Sie die ID des verbundenen Kontos im Attribut transfer_data[destination]
:
In diesem Beispiel wird das Test-Token tok_visa verwendet; stattdessen können Sie aber auch mit Stripe.js und Elements eine Testkarte tokenisieren.
Weitere Informationen finden Sie unter Zahlung annehmen.
Gebühren für Destination Charges mit application_fee_amount
erheben
Beim Erstellen von Destination Charges mit einem application_fee_amount
wird der vollständige Zahlungsbetrag sofort von der Plattform auf das Konto transfer_data[destination]
überwiesen, nachdem die Zahlung erfasst wurde. Anschließend wird der application_fee_amount
(maximal in Höhe des vollständigen Zahlungsbetrages) zurück auf die Plattform überwiesen.
Für eine bessere Berichterstellung wird nach der Erhebung der Plattformgebühr ein Plattformgebühr-Objekt erstellt. Für Berichtszwecke können Sie die Eigenschaft amount
im Plattformgebühr-Objekt nutzen. Anschließend können Sie diese Objekte mit dem Endpunkt Plattformgebühren aufrufen.
Gebühren für Destination Charges mit transfer_data[amount]
erheben
Sie können eine Gebühr auch mit transfer_data[amount] erheben.
transfer_data[amount]
ist eine positive Ganzzahl, die für den an transfer_data[destination]
überwiesenen Zahlungsbetrag steht. Sie ziehen die Gebühren Ihrer Plattform vom Zahlungsbetrag ab und übergeben dann das Ergebnis dieser Rechnung als transfer_data[amount]
:
Informationen zur Verfügbarkeit von Überweisungen, Rückerstattungen und mehr finden Sie unter Destination Charges.
Separate Zahlungen und Überweisungen
Vorsicht
Sie können separate Zahlungen und Überweisungen nur nutzen, wenn sich Ihre Plattform und das verbundene Konto in der gleichen Region befinden. Wenn sich das Konto Ihrer Plattform beispielsweise in Europa befindet, muss auch das verbundene Konto in Europa angesiedelt sein.
Um eine Zahlung zu erstellen und die zugehörige Überweisung einzurichten, erstellen Sie eine transfer_group
und weisen Sie die Zahlung der transfer_group
zu.
In diesem Beispiel wird das Test-Token tok_visa verwendet; stattdessen können Sie aber auch mit Stripe.js und Elements eine Testkarte tokenisieren.
Weitere Informationen finden Sie unter Zahlung annehmen.
Argument on_behalf_of mit separaten Zahlungen und Überweisungen verwenden
Mit separaten Zahlungen und Überweisungen gilt standardmäßig:
- Zahlungen werden im Land der Plattform beglichen
- Die Gebührenstruktur für das Land der Plattform wird verwendet
- Die Informationen der Plattform erscheinen auf der Kreditkartenabrechnung der Kund/innen
Um das Land des verbundenen Kontos zu verwenden und stattdessen diese Informationen anzuzeigen, nutzen Sie das Argument on_behalf_of
.
Vorsicht
Sie können on_behalf_of
mit separaten Zahlungen und Überweisungen nur für verbundene Konten mit der Funktion card_payments nutzen.
Informationen zur Verfügbarkeit von Überweisungen, Rückerstattungen und mehr finden Sie unter Separate Zahlungen und Überweisungen erstellen.