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

Empfänger/innen über Stripe-Formular erstellenÖffentliche Vorschau

Erfahren Sie, wie Sie Empfänger/innen mithilfe eines von Stripe gehosteten Formulars onboarden.

Verwenden Sie das von Stripe gehostete Webformular, um Empfängerinformationen zu erfassen. Das Formular wird für jede/n Empfänger/in dynamisch gerendert, basierend auf Funktionen, Land und Auszahlungsmethoden.

Verwenden Sie die Account Links API, um programmgesteuert Links zu generieren, mit denen Sie Informationen über von Stripe gehostete Formulare erfassen können. Die Formulare werden für jede/n Empfänger/in dynamisch gerendert, basierend auf Funktionen, Land und Auszahlungsmethoden. Außerdem können Sie sie mit Ihrem Firmennamen, Ihren Markenfarben und Ihrem Symbol anpassen. Empfänger/innen füllen das gehostete Formular aus und übermitteln die erforderlichen Angaben, einschließlich Auszahlungsdaten (z. B. Bankkonto und Routingnummer), direkt an Stripe.

Empfänger/in gibt seine/ihre Informationen in das Formular ein
Empfänger/innen stimmen zu, ihre Auszahlungsdaten mit Stripe zu verknüpfen
Ein Bestätigungsbildschirm zeigt Empfänger/innen, dass sie bereit sind, Auszahlungen zu empfangen

Unterstützte Browser

Die von Stripe gehostete Datenerfassung unterstützt Desktop- und Mobil-Browser mit folgenden Versionen:

  • Die letzten 20 Hauptversionen von Chrome und Firefox
  • Die letzten beiden Hauptversionen von Safari und Edge.
  • Die letzten beiden Hauptversionen des mobilen Safari für iOS.
  • Keine iFrame-Umgebungen

Erfassungsformular anpassen

Um von Stripe gehostete Formulare anzupassen, öffnen Sie im Dashboard die Einstellungen für Unternehmensbranding und hinterlegen Sie Firmenname, Farbe und Symbol.

Empfänger/in erstellen

Öffentliche Vorschau

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

Verwenden Sie die Accounts v2 API, um Ihre/n Empfänger/in zu erstellen. Sie müssen Ihre vorgesehenen Auszahlungsmethoden angeben, da einige Methoden zusätzliche Empfängerinformationen benötigen, bevor wir sie aktivieren können. Die Methoden, die Sie mit dem Parameter capabilities aktivieren, geben vor, welche Empfängerinformationen 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.

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-02-25.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": [
        "requirements",
        "configuration.recipient",
        "identity"
    ]
  }'

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.

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 Banküberweisungsnetzwerke wie Fedwire oder SWIFT empfangen.
Kartenconfiguration.recipient.capabilities.cardsSo kann das Konto OutboundPayments über Debitkarten-Netzwerke 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.

Teilbaren Link erstellen

Erstellen Sie einen teilbaren Link mit der Account Link API. Sie senden diesen Link an Ihre/n Empfänger/in, der/die dann Zugriff auf das Erfassungsformular hat, um die erforderlichen Informationen direkt an Stripe zu übermitteln. Jede AccountLink-URL läuft 10 Minuten nach der Generierung ab und kann nur einmal verwendet werden. Wenn Ihr/e Empfänger/in nach dem 10-Minuten-Fenster auf den AccountLink klickt, wird er/sie aus Sicherheitsgründen zur refresh.url weitergeleitet. Nachdem Ihr/e Empfänger/in seine/ihre Informationen angegeben hat, leitet der AccountLink zur return.url weiter.

Private Vorschau

Sie möchten Ihre Empfänger/innen verifizieren? Nachdem Empfänger/innen ihre Angaben zur Auszahlung in von Stripe gehosteten Formularen mitgeteilt haben, verwenden Sie die Financial Connections API, um die mit dem verknüpftes Konto verknüpften Angaben zur Inhaberschaft anzuzeigen und zu bestätigen. Wenn Sie Zugriff erhalten möchten,

Um einen gemeinsam nutzbaren Link zu erstellen, fügen Sie die folgenden Parameter ein:

  • account: Die Konto-ID der Empfängerin oder des Empfängers, die Sie mit der Accounts v2 API abrufen können
  • use_case.type: Wenn Sie die Empfänger/inneninformationen zum ersten Mal erfassen, geben Sie Konto_Onboarding an.
  • use_case.account_onboarding.configurations: Auf Empfänger/in festlegen.
  • use_case.Account_Onboarding.return_url: Die Seite, auf die Stripe den/die Empfänger/in weiterleitet, wenn der AccountLink bereits besucht wurde, abgelaufen oder anderweitig ungültig ist.
  • use_case.konto_Onboarding.refresh_url: Die Seite, auf die Stripe Empfänger/innen weiterleitet, nachdem sie das Formular zur Datenerfassung ausgefüllt oder verlassen haben.

Mit der folgenden Anfrage wird ein AccountLink für die erstmalige Erfassung von Empfänger/in erstellt:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_onboarding",
        "account_onboarding": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'

Authentifizieren Sie Empfänger/innen in Ihrer Anwendung, bevor Sie sie an diese URL weiterleiten.

Private Vorschau

Möchten Sie zusätzliche Authentifizierungstools? Stripe bietet auch eine Funktion zur einmaligen Authentifizierung Ihrer Empfänger/innen, indem Sie einen Authentifizierungscode an ihre E-Mail senden und sie dann zu einem neuen AccountLink weiterleiten. Wenn Sie Zugriff erhalten möchten,

Confirmation-of-Payee-Prüfung Nur Vereinigtes Königreich

Bevor wir eine Auszahlungen an Empfänger/innen im Vereinigten Königreich vornehmen, muss eine Confirmation of Payee-Prüfung durchgeführt werden. Führen Sie diese Prüfung durch, wenn Sie das Bankkonto erstellen, oder verwenden Sie einen separaten API-Aufruf.

Sie können die folgenden Parameter für /v2/payment_methods/gb_bank_accounts in Ihrer Anfrage bereitstellen:

API-ParameterPflichtfeldBeschreibung
account_numberJaDie Kontonummer des Bankkontos.
sort_codeJaDie Bankleitzahl des Bankkontos (nur numerisch).
confirmation_of_payeeNeinLegt fest, ob das Bankkonto Ihres Empfängers/Ihrer Empfängerin überprüft werden soll.

Der Stripe-Kontext-Header in diesen Anfragen muss die Konto-ID des Empfängers/der Empfängerin sein.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "sort_code": "108800",
    "account_number": "00012345",
    "confirmation_of_payee": {
        "initiate": true
    }
  }'

Nachfolgend finden Sie eine Beispielantwort:

{
  "id": "gbba_123",
  "object": "payment_methods.gb_bank_account",
  "bank_account_type": "checking",
  "bank_name": "Test Bank",
  "created": "2023-05-15T16:29:15.738Z",
  "deactivated": false,
  "last4": "2345",
  "sort_code": "108800",
  "confirmation_of_payee": {
    "result": {
      "created": "2024-10-18T19:19:31.000Z",
      "match_result": "mismatch",
      "matched": {
        "business_type": null,
        "name": ""
      },
      "message": "The provided information does not match the information the bank has on file for this account.",
      "provided": {
        "business_type": "business",
        "name": "John Smith"
      }
    },
    "status": "awaiting_acknowledgement"
  },
}

Wenn das Ergebnis der Bestätigung des Zahlungsempfängers/der Zahlungsempfängerin eine Übereinstimmung ist, können Sie sofort Gelder an dieses Ziel senden. Wenn das Ergebnis eine Teilübereinstimmung oder eine Nichtübereinstimmung ist oder der Dienst nicht verfügbar ist, müssen Sie das Ergebnis zuerst bestätigen:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts/gbba_1234/acknowledge_confirmation_of_payee \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

Überprüfen Sie diese Bankkonten, um sicherzustellen, dass sie korrekt sind, bevor Sie sie bestätigen. Sie können nicht übereinstimmende Bankkonten auch im Dashboard überprüfen.

Prüfen, ob Empfänger/innen aktiviert sind

Damit Empfänger/innen Auszahlungen annehmen können, müssen Sie Angaben zu Empfänger/innen und den vorgesehenen Auszahlungsmethoden erfassen.

Nachdem ein/e Empfänger/in das Erfassungsformular über den teilbaren Link geöffnet und die erforderlichen Angaben übermittelt haben, wird der Webhook v2.core.account_link.returned ausgelöst. Wenn Sie dieses Webhook-Ereignis überwachen, wissen Sie, wann der AccountLink-Vorgang erfolgreich abgeschlossen wurde und der/die Empfänger/in bereit ist, Auszahlungen zu akzeptieren. Erfahren Sie mehr über Webhooks und deren Verarbeitung.

Alternativ können Sie auch über das Dashboard oder die Accounts v2 API ermitteln, ob ein/e Empfänger/in bereit ist, Auszahlungen anzunehmen.

  1. Navigieren Sie zu Empfänger/innen und wählen Sie die/den Empfänger/in aus.
  2. Bestätigen Sie, dass keine zusätzlichen Informationen erforderlich sind. Wenn wir zusätzliche Angaben von Empfänger/innen benötigen (z. B. „Informationen erforderlich“ oder „Standard-Bankkonto nicht eingerichtet“), wird auf der Seite ein Banner angezeigt. Andernfalls ist die Erfassung der Empfängerinformationen abgeschlossen.
  3. Bestätigen Sie, dass mindestens eine Auszahlung unter Auszahlungen aktiviert ist. Wenn nicht, müssen Sie eine Auszahlungsmethode erfassen, indem Sie entweder einen anderen Link teilen oder die API verwenden. Um einen weiteren teilbaren Link zu erstellen, verwenden Sie erneut die Account Links API.

Bestehende/n Empfänger/in aktualisieren

Sie können Empfänger/innen erlauben, ihre Angaben im von Stripe gehosteten Formular zu aktualisieren, indem Sie einen weiteren teilbaren Link mit der Account Links API erstellen.

Um einen neuen teilbaren Link zu erstellen, fügen Sie Folgendes ein:

  • account: Die Konto-ID der Empfängerin oder des Empfängers, die Sie mit der Accounts v2 API abrufen können
  • use_case.type: Specify account_update.
  • use_case.account_update.configurations: Auf Empfänger/in setzen.
  • use_case.account_update.return_url: Die Seite, zu der Stripe Empfänger/innen weiterleitet, wenn der AccountLink bereits aufgerufen wurde oder abgelaufen oder aus anderen Gründen ungültig ist.
  • use_case.account_update.refresh_url: Die Seite, zu der Stripe Empfänger/innen weiterleitet, nachdem sie das Formular zur Datenerfassung ausgefüllt oder verlassen haben.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-02-25.preview" \
  --json '{
    "account": "{{ACCOUNT_ID}}",
    "use_case": {
        "type": "account_update",
        "account_update": {
            "configurations": [
                "recipient"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/reauth"
        }
    }
  }'

Ähnlich wie beim AccountLink, der zum Erstellen des Empfängers verwendet wird, läuft die URL nach 10 Minuten ab und kann nur einmal verwendet werden. Wenn Ihr Empfänger die URL nach dem Zeitfenster von 10 Minuten oder mehr als einmal öffnet, leiten wir ihn an die refresh.url weiter.

Auf dieser Seite