Empfängererstellung mit der APIÖffentliche Vorschau

Erstellen Sie einen Informationserfassungsablauf für Ihre Empfänger/innen, um Details zu Empfänger- und Auszahlungsmethoden zu erfassen, und übergeben Sie diese Informationen dann über unsere APIs an Stripe. Ihr Unternehmen ist für alle Interaktionen mit Ihren Empfängern/Empfängerinnen und für die Erfassung aller zu deren Verifizierung erforderlichen Informationen verantwortlich. Wir aktualisieren die Verifizierungsanforderungen, wenn sich Gesetze und Vorschriften weltweit ändern. Planen Sie, die Onboarding-Anforderungen regelmäßig zu überprüfen und zu aktualisieren, um fehlgeschlagene Auszahlungen zu vermeiden.

Um eine/n Empfänger/in zu erstellen, der/die Auszahlungen empfangen kann, müssen Sie Folgendes erstellen:

• Ein/e aktive/r Empfänger/in mit der Accounts v2 API
• Eine aktivierte Auszahlungsmethode mit der USBankAccount API v2

Formulare zum Erfassen von Informationen erstellen

Um eine Auszahlung zu tätigen, müssen Sie Informationen von Ihrem Empfänger/Ihrer Empfängerin erfassen. Erstellen Sie eine Methode oder ein Formular, damit Ihre Empfänger/innen Informationen übermitteln können, die Sie dann über die API an Stripe übermitteln.

Da die Verifizierungsanforderungen von rechtlichen und regulatorischen Anforderungen abhängen, können sich die zu erfassenden Informationen ändern. Entwerfen Sie Ihre Anwendungslogik für die Möglichkeit zusätzlicher Parameter in der Zukunft.

Empfänger/in erstellen

Verwenden Sie die Accounts v2 API, um Ihre/n Empfänger/in zu erstellen. Sie müssen die folgenden Parameter angeben, um die Konto-ID zu erstellen:

Sie müssen Ihre gewünschten Auszahlungsmethoden mit der Accounts v2 API angeben, da einige Methoden zusätzliche Informationen über Ihre/n Empfänger/in erfordern, bevor wir sie aktivieren können. capabilitiesDie Methoden, die Sie mit dem Parameter capabilities aktivieren, bestimmen die Informationen, die Sie für Ihre Empfänger/innen erfassen müssen. Beispielsweise erfordert configuration.recipient.capabilities.bank_accounts.local für eine/n US-Empfänger/in, dass Sie eine Kontonummer und eine Routingnummer angeben.

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

Nachdem Sie diese Felder hinzugefügt und Auszahlungsmethoden angefordert haben, ermittelt Stripe die zusätzlichen Informationen, die in der API-Antwort erforderlich sind und übermittelt werden müssen, damit der/die Empfänger/in für den Empfang von Auszahlungen bereit ist. Um diese Anforderungen zu erhalten, fügen Sie requirements, configuration.recipient und identity im include-Array ein. Andernfalls gibt Stripe unabhängig vom tatsächlichen Wert eine Null-Antwort zurück.

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 jedes dieser Felder, die Sie nicht angeben, enthält die Antwort sie als „null“, unabhängig von ihrem tatsächlichen Wert.

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-03-31.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"
    ]
  }'

Erforderliche Felder zur Aktivierung eines Empfängers/einer Empfängerin bestimmen

Verwenden Sie die Antwort von der Accounts v2 API, um die requirements.entries zu prüfen und die spezifischen Felder zu bestimmen, die Sie an Stripe übermitteln müssen. Alle entries mit dem Feld restricts_capabilities sind erforderlich, damit der/die Empfänger/in Auszahlungen annehmen kann.

{
 "id": "acct_1R9UxIQlxdq9VtNU",
 "object": "v2.core.account",
 "applied_configurations": [
   "recipient"
 ],
 "configuration": {
   "customer": null,
   "merchant": null,
   "recipient": {
     "capabilities": {
       "bank_accounts": {
         "local": {
           "requested": true,
           "status": "restricted",
           "status_details": [
             {
               "code": "requirements_past_due",
               "resolution": "provide_info"
             }
           ]
         },
         "wire": null
       },
       "cards": null,

Empfängerinformationen an Stripe senden

Nachdem Sie die zusätzlichen Felder ermittelt haben, die Sie einreichen müssen, verwenden Sie die Accounts v2 API, um die erforderlichen Informationen zu übermitteln.

curl -X POST https://api.stripe.com/v2/core/accounts/acct_1234 \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual",
        "individual": {
            "address": {
                "city": "Brothers",
                "country": "US",
                "line1": "27 Fredrick Ave",
                "postal_code": "97712",
                "state": "OR",
                "id_numbers": [
                    {
                        "type": "us_ein",
                        "value": "000000000"
                    }
                ]
            }
        }
    },
    "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 über die von Ihnen angegebene Auszahlungsmethode erhalten können.

curl -G https://api.stripe.com/v2/core/accounts/acct_1234 \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  -d include=identity \
  -d include="configuration.recipient"

Auszahlungsmethoden für Ihre Empfänger/innen erstellen

Verwenden Sie die USBankAccount v2 API, um Details zur Auszahlungsmethode an Stripe zu übermitteln, damit eine Auszahlung an einen Empfänger/eine Empfängerin erfolgen kann.

USBankAccounts können Auszahlungen per ACH oder Überweisung erhalten. Wenn Sie beabsichtigen, Auszahlungen per Banküberweisung zu senden, geben Sie bitte die fedwire_routing_number an. Es fallen zusätzliche Gebühren an. Weitere Informationen finden Sie unter Preise.

Der Stripe-Context-Header in dieser Anfrage muss die Konto-ID des Empfängers/der Empfängerin sein.

curl -X POST https://api.stripe.com/v2/core/vault/us_bank_accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-06-30.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "routing_number": "110000000",
    "account_number": "000123456789",
    "fedwire_routing_number": "110000000"
  }'

Sie können auch Debitkarten als Auszahlungsmethode verwenden. Ihre Empfänger/innen müssen ihre Debitkarteninformationen jedoch direkt an Stripe übermitteln. Wenn Sie Auszahlungen per Debitkarte aktivieren möchten, verwenden Sie die Account Links v2 API, um ein gemeinsam nutzbares Formular zu erstellen, mit dem Ihre Nutzer/innen ihre Debitkarten-Anmeldedaten übermitteln können.

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

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

Der Stripe-Context-Header in dieser Anfrage muss die Konto-ID des Empfängers/der Empfängerin sein.

curl https://api.stripe.com/v2/money_management/payout_methods \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-06-30.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

Die Antwort enthält eine Liste der PayoutMethod-Objekte, die im Besitz eines Empfängers/einer Empfängerin sind. Verwenden Sie die PayoutMethod-IDs, um eine Auszahlung mit der OutboundPayments API vorzunehmen. Weitere Informationen finden Sie unter Geld senden.