Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

Empfänger/in für Global Payouts mit der API erstellenÖffentliche Vorschau

Erfahren Sie, wie Sie Empfänger/innen mit der Stripe API für Global Payouts onboarden.

Erstellen Sie einen Ablauf zur Datenerfassung, um Angaben zu Empfänger/innen und Auszahlungsmethoden zu erfassen, und übermitteln Sie diese anschließend über unsere APIs an Stripe.

Hinweise

Ihr Unternehmen ist für alle Interaktionen mit Empfänger/innen verantwortlich und muss alle zur Verifizierung erforderlichen Angaben erfassen. Stripe aktualisiert die Verifizierungsanforderungen, sobald sich Gesetze und Vorschriften weltweit ändern.

Berücksichtigen Sie beim Aufbau einer Auszahlungsintegration Folgendes:

  • Änderungen an rechtlichen und regulatorischen Anforderungen regelmäßig prüfen.
  • Ihre Anwendungslogik entsprechend anpassen.

Planen Sie, die Onboarding-Anforderungen regelmäßig zu prüfen und zu aktualisieren, um fehlgeschlagene Auszahlungen zu vermeiden.

Empfänger/in erstellen

Wenn Sie Empfängerdaten für Auszahlungen über ein Formular erfassen, verwenden Sie die Accounts v2 API, um Empfänger/innen zu erstellen. Sie müssen die folgenden Parameter angeben, um die Konto-ID zu erstellen:

Erforderliche InformationenParameter
Land der Empfängerin/des Empfängersidentity.country
Art der Geschäftstätigkeit der Empfängerin oder des Empfängersidentity.entity_type
E-Mail-Adresse der Empfängerin/des Empfängerscontact_email
Der Anzeigename des Kontos. Er erscheint im Stripe-Dashboard und auf allen Rechnungen, die Sie an das Konto senden.display_name
Auszahlungsmethoden, die Sie aktivieren möchtenconfiguration.recipient.capabilities

Öffentliche Vorschau

Grenzüberschreitende Auszahlungen für US-Absender sind in der öffentlichen Vorschau verfügbar.

Sie müssen die vorgesehenen Auszahlungsmethoden mit der Accounts v2 API angeben, da einige Methoden zusätzliche Angaben zu Empfänger/innen benötigen, bevor sie aktiviert werden können. Die Methoden, die Sie mit dem Parameter capabilities aktivieren, geben vor, welche Angaben Sie erfassen müssen. Zum Beispiel erfordert configuration.recipient.capabilities.bank_accounts.local für Empfänger/innen in den USA, dass Sie eine Kontonummer und eine Routingnummer eingeben.

AuszahlungsmethodeAPI-ParameterBeschreibung
Lokale Bankconfiguration.recipient.capabilities.bank_accounts.localSo kann das Konto OutboundPayments über lokale Banknetzwerke wie ACH oder FPS empfangen.
Banküberweisungconfiguration.recipient.capabilities.bank_accounts.wireSo kann das Konto OutboundPayments über Überweisungsnetzwerke wie Fedwire oder SWIFT empfangen.
Kartenconfiguration.recipient.capabilities.cardsSo kann das Konto OutboundPayments über Debitkartennetzwerke wie Visa Direct oder Mastercard Send empfangen.

Für Empfänger/innen können mehrere Auszahlungsmethoden aktiviert sein. Nicht alle Auszahlungsmethoden sind für Empfänger/innen in allen Ländern verfügbar. Sehen Sie sich die vollständige Liste der verfügbaren Auszahlungsmethoden nach Landan.

Nachdem Sie diese Felder hinzugefügt und Auszahlungsmethoden angefordert haben, ermittelt Stripe in der API-Antwort, welche zusätzlichen Angaben erforderlich sind, damit Empfänger/innen Auszahlungen empfangen können.Um diese Anforderungen zu erhalten, beziehen Sie requirements, configuration.recipient und identity in das include-Array mit ein. Andernfalls enthält die Antwort diese Felder unabhängig vom tatsächlichen Wert als null.

Wenn Sie ein Konto erstellen, abrufen oder aktualisieren, werden bestimmte Felder in der Antwort nur ausgefüllt, wenn Sie sie im Parameter include angeben. Für alle Felder, die Sie nicht angeben, enthält die Antwort sie als Null, unabhängig von ihrem tatsächlichen Wert.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "bank_accounts": {
                    "local": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "identity",
        "configuration.recipient",
        "requirements"
    ]
  }'

Legen Sie erforderliche Felder fest, um eine/n Empfänger/in zu aktivieren

Verwenden Sie die Antwort der Accounts v2 API, um die requirements.entries zu überprüfen und die spezifischen Felder zu ermitteln, die Sie an Stripe übermitteln müssen. Alle entries mit dem Feld restricts_capabilities sind erforderlich, damit Empfänger/innen Auszahlungen akzeptieren können.

{
 "id": "{{CONNECTED_ACCOUNT_ID}}",
 "object": "v2.core.account",
 "applied_configurations": [
   "recipient"
 ],
 "configuration": {
   "customer": null,
   "merchant": null,
   "recipient": {

Übermitteln Sie Empfängerinformationen an Stripe

Nachdem Sie die zusätzlichen einzureichenden Felder bestimmt haben, verwenden Sie die Accounts v2 API, um die erforderlichen Informationen einzureichen. Verwenden Sie die id aus der obigen Antwort in der URI.

Command Line
cURL
No results
curl -X POST https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}}
 \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual",
        "individual": {
            "given_name": "Jenny",
            "surname": "Rosen",
            "address": {
                "city": "Brothers",
                "country": "US",
                "line1": "27 Fredrick Ave",
                "postal_code": "97712",
                "state": "OR"
            }
        }
    },
    "include": [
        "identity"
    ]
  }'

Bestätigen, dass der/die Empfänger/in aktiviert ist

Verwenden Sie die Accounts v2 API, um ein Konto abzurufen und den status der von Ihnen angeforderten Funktionen zu überprüfen. Der status muss active sein, damit Empfänger/innen Auszahlungen mit ihrer angegebenen Auszahlungsmethode erhalten können.

Command Line
cURL
No results
curl -G https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}}
 \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -d "include[0]"="configuration.recipient"

Erstellen Sie Auszahlungsmethoden für Ihre Empfänger/innen

Verwenden Sie die Schaltfläche OutboundSetupIntents v2 API, um Auszahlungsmethodendetails an Stripe zu senden und so eine Auszahlung an eine/n Empfänger/in zu ermöglichen.

Der Stripe-Kontext-Header in dieser Anfrage muss die Konto-ID des Empfängers sein.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/money_management/outbound_setup_intents \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "payout_method_data": {
        "type": "bank_account",
        "bank_account": {
            "country": "FR",
            "account_number": "FR76300060000112345678901234"
        }
    }
  }'

Hinweis

Die Antwort „OutboundSetupIntent“ enthält die darin verschachtelte Auszahlungsmethode. Verwenden Sie bei einer „OutboundPayment“-Zahlung die Auszahlungsmethoden-ID (z. B. frba_test_...) aus der Antwort und nicht die „OutboundSetupIntent“-ID (osi_test_...).

Um Auszahlungen per Überweisung zu senden, verwenden Sie die USBankAccount v2 API, um die fedwire_routing_number zur Auszahlungsmethode hinzuzufügen. Es fallen zusätzliche Gebühren an. Weitere Informationen finden Sie unter Preisgestaltung.

You can also use debit cards as a payout method. However, your recipients must submit their debit card information directly to Stripe. If you’re interested in enabling payouts by debit cards, use the Account Links v2 API to create a shareable form for your user to submit their debit card credentials.

Alle Auszahlungsmethoden für eine/n Empfänger/in anzeigen

Alle erstellten Auszahlungsmethoden für eine/n Empfänger/in anzeigen. Rufen Sie die Payout Methods API v2 auf und geben Sie die Empfänger-ID an.

Der Stripe-Kontext-Header in dieser Anfrage muss die Konto-ID des Empfängers sein.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v2/money_management/payout_methods \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

Die Antwort enthält eine Liste von PayoutMethod-Objekten, die ein/e Empfänger/in besitzt. Verwenden Sie die PayoutMethod-IDs, um eine Auszahlung mit der OutboundPayments API zu tätigen. Siehe Geld senden für weitere Details.