Stripe Connect und die Charges API

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 Connect-Zahlungen finden Sie in der Dokumentation zur Auswahl eines Verfahrens. 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:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa

In diesem Beispiel wird das Test-Token – tok_visa – verwendet. Stattdessen können Sie aber auch mit Stripe.js und Elements eine Testkarte mit Token versehen.

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:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123

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]:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

In diesem Beispiel wird das Test-Token – tok_visa – verwendet. Stattdessen können Sie aber auch mit Stripe.js und Elements eine Testkarte mit Token versehen.

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.

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

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 Endpoint 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]:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[amount]"=877 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Informationen zur Verfügbarkeit von Überweisungen, Rückerstattungen und mehr finden Sie unter Destination Charges.

Separate Zahlungen und Überweisungen

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.

# Create a Charge:
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=10000 \
  -d "currency"="usd" \
  -d "source"="tok_visa" \
  -d "transfer_group"="{ORDER10}"

# Create a Transfer to a connected account (later):
curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=7000 \
  -d "currency"="usd" \
  -d "destination"="{{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

# Create a second Transfer to another connected account (later):
curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "destination"="{{OTHER_CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

In diesem Beispiel wird das Test-Token – tok_visa – verwendet. Stattdessen können Sie aber auch mit Stripe.js und Elements eine Testkarte mit Token versehen.

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.

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}

Informationen zur Verfügbarkeit von Überweisungen, Rückerstattungen und mehr finden Sie unter Separate Zahlungen und Überweisungen erstellen.