Getrennte Gelder für separate Zahlungen und ÜberweisungenPrivate Vorschau

Die Mitteltrennung ermöglicht es Ihnen, Gelder aus getrennten Zahlungen und Überweisungen auf Ihrem Plattformkonto in einem Treuhandstatus zu reservieren, bevor Sie sie an verbundene Konten überweisen. Gelder in diesem Status erscheinen nicht im Plattform-Saldo und können nur an verbundene Konten übertragen werden.

Sie können den zugewiesenen Saldo einer bestimmten Zahlung einsehen, um den vollständigen Verlauf dieser Gelder nachzuverfolgen.

Die Zuteilung von Geldern verhindert, dass diese für andere Zwecke verwendet werden, wie zum Beispiel:

• Automatische Auszahlungen auf Plattformebene
• Unverbundene Rückerstattungen und Rückbuchungen
• Stripe-Gebühren
• Andere Abbuchungen vom Zahlungssaldo Ihrer Plattform

Verfügbar in:

Voraussetzungen und Einschränkungen

Bevor Sie eine Trennung der Gelder vornehmen, sollten Sie diese Anforderungen und Einschränkungen prüfen:

Anforderungen

• Ihre Plattform muss für negative Salden auf verbundenen Konten Verantwortung übernehmen.
• Sie müssen die Vorschau-Kopfzeile allocated_funds_preview=v1 in alle API-Anfragen aufnehmen.

Beschränkungen

• Das Stripe-Dashboard weist keine zugewiesenen Gelder aus. Alle Guthaben und Transaktionen im Dashboard können sowohl zugewiesene als auch andere Gelder enthalten.
• Alle Gebührenabrechnungen erfolgen asynchron; Transaktionsgebühren werden möglicherweise nicht gleichzeitig mit der Zahlung angezeigt. Die Gebühren werden später dem Stripe-Guthaben der Plattform belastet.
• Sie können die Details der zugewiesenen Gelder nur einsehen, indem Sie einzelne Charge-Objekte erweitern.
• Vermeiden Sie die Verwendung des Parameters automatic_payment_methods. Zugewiesene Gelder können nur aus Zahlungen mit den Zahlungsmethoden Visa, Mastercard, Discover, American Express und Swish abgeleitet werden.
• Sie können die Trennung von Geldern nicht mit Übererfassung, Mehrfacherfassung oder inkrementelle Autorisierung verwenden.
• Sie können grenzüberschreitende Auszahlungen nicht mit der Trennung von Geldern in den USA verbinden. Sie können zugewiesene Gelder nur auf verbundene Konten in den USA übertragen.

Zahlungen mit zugewiesenen Geldern erstellen

Um die Trennung der Gelder zu verwenden, erstellen Sie einen PaymentIntent mit der Einstellung allocated_funds auf enabled: true. Beim Erfassen der Zahlung weist Stripe die Gelder zu.

Sie können den Fluss der zugewiesenen Gelder verfolgen, indem Sie einen eindeutigen transfer_group Wert angeben.

Nach erfolgreicher Erfassung steht der gesamte Betrag (abhängig vom Zeitpunkt der Zahlungsabwicklung) als zugewiesenes Geld zur Verfügung, das Sie auf ein verbundenes Konto übertragen können.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d "allocated_funds[enabled]"=true \
  -d amount=10000 \
  -d currency=eur \
  -d payment_method=pm_xxxxxxxxx \
  -d transfer_group=ORDER100 \
  -d confirm=true \
  -d capture_method=automatic

Zugewiesene Gelder für eine bestimmte Zahlung anzeigen

Um den Saldo der zugewiesenen Gelder aus einer bestimmten Zahlung anzuzeigen, erweitern Sie die Eigenschaft allocated_funds.balance der Zahlung:

curl -G https://api.stripe.com/v1/payment_intents/
{{PAYMENT_INTENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d "expand[]"="latest_charge.allocated_funds.balance"

{
  "id": "{{PaymentIntent ID}}",
  "object": "payment_intent",
  "latest_charge": {
    "id": "{{Charge ID}}",
    "object": "charge",
    "allocated_funds": {
      "enabled": true,
      "balance": {
        "available": 0,
        "pending": 10000,
        "currency": "eur"
      }
    }
  }
}

Übertragung von zugewiesenen Geldern

Wenn Sie zugewiesene Gelder übertragen, müssen Sie den Parameter source_transaction auf die ID der verbundenen Zahlung und den Parameter destination auf die ID des verbundenen Kontos setzen.

Wenn Sie einen Betrag für die Plattformgebühr festlegen, wird dieser von den zugewiesenen Geldern abgezogen und Ihrem Plattform-Zahlungssaldo gutgeschrieben. Die Antwort auf die Überweisungserstellung enthält Informationen zur Plattformgebühr.

curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d destination="{{Connected Account ID}}" \
  -d source_transaction="{{Charge ID}}" \
  -d amount=3800 \
  -d currency=eur \
  -d application_fee_amount=200

Sie müssen den vollständigen Zahlungsbetrag nicht in einer einzigen Überweisung oder an ein einziges verbundenes Konto übertragen. Sie können zugewiesene Gelder auf mehrere Überweisungen aufteilen, solange der Gesamtbetrag den ursprünglichen Zahlungsbetrag nicht überschreitet.

Die Antwort auf die Übertragung enthält Einzelheiten über die Plattformgebühr, wenn diese angegeben ist:

{
  "id": "{{Transfer ID}}",
  "object": "transfer",
  "amount": 3800,
  "currency": "eur",
  "destination": "{{Connected Account ID}}",
  "source_transaction": "{{Charge ID}}",
  "application_fee_amount": 200,
  "application_fee": {
    "id": "{{Application Fee ID}}",
    "object": "application_fee",
    "amount": 200,
    "currency": "eur",
    "fee_source": {
      "type": "transfer",
      "transfer": "{{Transfer ID}}"
    }
  }
}

Das Einziehen von Plattformgebühren bei Überweisungen verschiebt die Mittel direkt von den zugewiesenen Mitteln auf das Guthaben des Plattformkontos. Dies vermeidet unnötige Fremdwährungsumrechnungen (FX), wenn die Währung der Plattform und die Währung des verbundenen Kontos unterschiedlich sind, da die Plattformgebühr das Plattformkonto niemals verlässt.

Rückerstattungen und Zahlungsanfechtungen

Rückerstattungen und Anfechtungen für Zahlungen mit zugewiesenen Geldern werden von diesen zugewiesenen Geldern abgezogen, bevor Guthaben von Ihrem Plattform-Konto verwendet werden. Stripe belastet Ihr Plattform-Konto nur dann, wenn das verbleibende zugewiesene Geld der zugehörigen Zahlung die Rückerstattung oder Anfechtung nicht abdecken kann.

Wenn Sie, beispielsweise, 60 EUR aus einer Zahlung über 100 EUR überwiesen haben und anschließend eine Rückerstattung über 100 EUR durchführen:

• 40 EUR stammen aus den verbleibenden zugewiesenen Geldern.
• 60 EUR werden vom Guthaben Ihres Kontos bei der Plattform abgezogen.

Anfechtungsgebühren werden immer vom Saldo Ihres Kontos auf der Plattform abgebucht und haben keinen Einfluss auf die zugewiesenen Gelder.

Mit Transfer Reversals können Sie Gelder von einem verbundenen Konto auf das zugewiesene Guthaben zurückführen, bevor Sie eine Rückerstattung bearbeiten oder während Sie das Ergebnis einer Anfechtung abwarten:

curl https://api.stripe.com/v1/transfers/
{{TRANSFER_ID}}
/reversals \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=6000 \
  -d refund_application_fee=true

Stornierungen von Überweisungen führen immer dazu, dass Gelder in einen zugewiesenen Status überführt werden, wenn die ursprüngliche Zahlung zugewiesen war.

Wenn Sie den Parameter refund_application_fee auf true setzen, bucht Stripe auch den Betrag der Anmeldegebühr vom Transaktionsguthaben Ihrer Plattform ab und setzt ihn in den zugewiesenen Zustand zurück.

Wenn Sie eine Übertragung von zugewiesenen Geldern stornieren, die in eine Anfechtung verwickelt sind, bleiben diese unabhängig vom Ausgang der Anfechtung zugewiesen. Anfechtungsgebühren können nicht zurückgefordert werden.

Wenn die Anfechtung zu Ihren Gunsten entschieden wird, können Sie die zugewiesenen Gelder zurück auf Ihr verbundenes Konto übertragen. Wenn die Anfechtung nicht zu Ihren Gunsten entschieden wird, können Sie sich an Stripe wenden, um anzufragen, ob wir die Zuweisung des Geldes aufheben und es Ihrem Konto auf der Plattform gutschreiben.

Überweisen Sie zugewiesene Gelder auf das Guthaben Ihres Plattformkontos

Sie können Saldoübertragungen verwenden, um Gelder von Ihren zugewiesenen Geldern auf das Saldo Ihres Plattformkontos zu übertragen. Dies ist nützlich, um ein hängendes Saldo auszugleichen oder eine Plattformgebühr zu einem anderen Zeitpunkt als direkt bei der Zahlung oder Übertragung einzuziehen. Die ausgewählte Währung muss mit der Währung übereinstimmen, in der die Zahlung abgewickelt wurde.

Zum Beispiel kann ein hängendes Guthaben in den zugewiesenen Mitteln entstehen, wenn eine Zahlungsanfechtung durch die/den Kundin/Kunden zunächst aus dem Plattformkontoguthaben erstattet wurde und Sie später die Überweisung von der Verkäuferin/vom Verkäufer rückgängig gemacht haben. In diesem Szenario befinden sich die zurückgeholten Mittel in Ihren zugewiesenen Mitteln, aber da die Kundin/der Kunde bereits erstattet wurde, möchten Sie diese zugewiesenen Mittel wahrscheinlich auf das Guthaben Ihres Plattformkontos übertragen.

curl https://api.stripe.com/v1/balance_transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; allocated_funds_preview=v1" \
  -d amount=6000 \
  -d currency=eur \
  -d "destination_balance[type]"=payments \
  -d "source_balance[type]"=allocated_funds \
  -d "source_balance[allocated_funds][type]"=charge \
  -d "source_balance[allocated_funds][charge]"="{{Charge ID}}"

Test der Geldertrennung

Sie können zugewiesene Gelder nur in Sandbox Umgebungen testen, nicht im Test-Modus. Lesen Sie die Testanleitung, um Zahlungen für Ihre Integration zu simulieren.