# Empfänger/in für Global Payouts mit der API erstellen 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änger/innen für Auszahlungen über ein Formular erfassen, verwenden Sie die [Accounts API v2](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=preview), um Empfänger/innen zu erstellen. Sie müssen die folgenden Parameter angeben, um die `Konto`-ID zu erstellen: | Erforderliche Informationen | Parameter | | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | | Land der Empfängerin/des Empfängers | `identity.country` | | Art der Geschäftstätigkeit der Empfängerin oder des Empfängers | `identity.entity_type` | | E-Mail-Adresse der Empfängerin/des Empfängers | `contact_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öchten | `configuration.recipient.capabilities` | > Grenzüberschreitende Auszahlungen für US-Absender sind in der öffentlichen Vorschau verfügbar. Sie müssen die gewünschten Auszahlungsmethoden angeben, indem Sie bei der [Erstellung des Kontos](https://docs.stripe.com/connect/account-capabilities.md?accounts-namespace=v2) die [entsprechenden Funktionen](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=preview#v2_create_accounts-configuration-recipient-capabilities) anfordern. | Auszahlungsmethode | API-Parameter | Beschreibung | | ------------------ | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | Lokale Bank | `configuration.recipient.capabilities.bank_accounts.local` | So kann das `Konto` `OutboundPayments` über lokale Banknetzwerke wie ACH oder FPS empfangen. | | Banküberweisung | `configuration.recipient.capabilities.bank_accounts.wire` | So kann das `Konto` `OutboundPayments` über Überweisungsnetzwerke wie Fedwire oder SWIFT empfangen. | | Karten | `configuration.recipient.capabilities.cards` | So kann das `Konto` `OutboundPayments` über Debitkartennetzwerke wie Visa Direct oder Mastercard Send empfangen. | Ein Empfänger bzw. eine Empfängerin kann mehrere Auszahlungsmethoden aktiviert haben. Nicht alle Auszahlungsmethoden sind für Empfänger/innen in allen Ländern verfügbar. Die vollständige Liste der [verfügbaren Auszahlungsmethoden nach Land finden Sie hier](https://docs.stripe.com/global-payouts/recipient-creation-options.md#requirements-for-supported-recipient-countries). Für einige Funktionen sind zusätzliche Informationen über Ihre/n Empfänger/in erforderlich. Beispielsweise müssen Sie für `configuration.recipient.capabilities.bank_accounts.local` für eine/n Empfänger/in in den USA eine Kontonummer und eine Bankleitzahl angeben. Nachdem Sie die Funktionen für Auszahlungsmethoden angefordert haben, ermittelt Stripe die zusätzlichen Informationen, die Sie zur Aktivierung dieser Funktionen übermitteln müssen und gibt diese in der API-Antwort an. Um die Anforderungen in der Antwort zu erhalten, fügen Sie `Anforderungen`, `configuration.recipient` und `Identität` in das `Einbeziehen`-Array ein. Andernfalls gibt Stripe für diese Eigenschaften eine Null-Antwort zurück, unabhängig von ihren tatsächlichen Werten. ```curl curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-04-22.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 Um die spezifischen Anforderungen zu ermitteln, die Sie übermitteln müssen, überprüfen Sie das Array [requirements.entries](https://docs.stripe.com/api/v2/core/accounts/create.md?api-version=preview#v2_create_accounts-response-requirements-entries) in der Accounts API-Antwort. Damit der Empfänger bzw. die Empfängerin Auszahlungen akzeptieren kann, müssen Sie alle Anforderungen angeben, die über die Eigenschaft `restricts_capabilities` verfügen. ```json { "id": "{{CONNECTED_ACCOUNT_ID}}", "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, "instant": null }, "cards": null, "stripe_balance": null }, "default_outbound_destination": null } }, "contact_email": "jenny.rosen@stripe.com", "created": "2025-04-02T17:20:00.000Z", "dashboard": null, "identity": { "attestations": { "directorship_declaration": null, "ownership_declaration": null, "persons_provided": { "directors": null, "executives": null, "owners": null, "ownership_exemption_reason": null }, "terms_of_service": { "account": null } }, "business_details": null, "country": "US", "entity_type": "individual", "individual": null }, "defaults": null, "display_name": "Jenny Rosen", "metadata": {}, "requirements": { "collector": "stripe", "entries": [ { "awaiting_action_from": "user", "description": "identity.individual.given_name", "errors": [], "impact": {"restricts_capabilities": [ { "capability": "bank_accounts.local", "configuration": "recipient", "deadline": { "status": "past_due" } } ], "restricts_payouts": null }, "minimum_deadline": { "status": "past_due" }, "reference": null, "requested_reasons": [ { "code": "routine_onboarding" } ] }, { "awaiting_action_from": "user", "description": "identity.individual.surname", "errors": [], "impact": { "restricts_capabilities": [ { "capability": "bank_accounts.local", "configuration": "recipient", "deadline": { "status": "past_due" } } ], "restricts_payouts": null }, "minimum_deadline": { "status": "past_due" }, "reference": null, "requested_reasons": [ { "code": "routine_onboarding" } ] } ], "summary": { "minimum_deadline": { "status": "past_due", "time": null } } } } ``` ## Übermitteln Sie Empfängerinformationen an Stripe Nachdem Sie die erforderlichen Informationen gesammelt haben, übermitteln Sie diese über die [Accounts-API](https://docs.stripe.com/api/v2/core/accounts/update.md?api-version=preview). ```curl curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}} \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-04-22.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 [Rufen Sie das Konto ab](https://docs.stripe.com/api/v2/core/accounts/retrieve.md?api-version=preview) und überprüfen Sie den `Status` der von Ihnen angeforderten Funktionen. Der `Status` einer Auszahlungsmethode muss `aktiv` sein, damit die Empfängerin bzw. der Empfänger Auszahlungen über diese Methode erhalten kann. ```curl curl -G https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}} \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-04-22.preview" \ -d "include[0]=configuration.recipient" ``` ## Erstellen Sie Auszahlungsmethoden für Ihre Empfänger/innen Nachdem Sie die Funktion einer Auszahlungsmethode aktiviert haben, verwenden Sie die [Outbound Setup Intents API](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/create.md?api-version=preview), um die tatsächliche `PayoutMethod` der Empfängerin bzw. des Empfängers zu erstellen. Der Stripe-Kontext-Header in dieser Anfrage muss die Konto-ID des Empfängers sein. ```curl curl -X POST https://api.stripe.com/v2/money_management/outbound_setup_intents \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-04-22.preview" \ -H "Stripe-Context: {{CONTEXT_ID}}" \ --json '{ "payout_method_data": { "type": "bank_account", "bank_account": { "country": "FR", "account_number": "FR76300060000112345678901234" } } }' ``` > Die Antwort `OutboundSetupIntent` enthält [die Auszahlungsmethode](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/create.md?api-version=preview#v2_create_outbound_setup_intents-response-payout_method). Verwenden Sie bei einer `OutboundPayment`-Zahlung die `PayoutMethod`-ID (z. B. `frba_test_...`) aus der Antwort und nicht die `OutboundSetupIntent`-ID (`osi_test_...`). Um Auszahlungen per Überweisung zu tätigen, verwenden Sie die [US Bank Accounts-API](https://docs.stripe.com/api/v2/core/vault/us-bank-accounts/update.md?api-version=preview), um die `fedwire_routing_number` zur `PayoutMethod` hinzuzufügen. Es fallen zusätzliche Gebühren an. Weitere Informationen finden Sie unter [Preise](https://docs.stripe.com/global-payouts/pricing.md). Sie können auch Debitkarten als Auszahlungsmethode verwenden. Ihre Empfänger/innen müssen ihre Debitkartendaten jedoch direkt an Stripe übermitteln. Wenn Sie Auszahlungen per Debitkarte aktivieren möchten, erstellen Sie mit der [Account Links API](https://docs.stripe.com/api/v2/core/account-links.md) ein teilbares Formular, über das Ihre Nutzer/innen ihre Debitkartendaten übermitteln können. ## Alle Auszahlungsmethoden für eine/n Empfänger/in anzeigen Verwenden Sie die [Payout Methods API](https://docs.stripe.com/api/v2/money-management/payout-methods/list.md?api-version=preview), um die Auszahlungsmethoden einer Empfängerin bzw. eines Empfängers abzurufen. Der Stripe-Kontext-Header in dieser Anfrage muss die `Konto-ID` der Empfängerin bzw. des Empfängers sein. ```curl curl https://api.stripe.com/v2/money_management/payout_methods \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-04-22.preview" \ -H "Stripe-Context: {{CONTEXT_ID}}" ``` Die Antwort enthält eine Liste der mit der Empfängerin bzw. dem Empfänger verbundenen `PayoutMethod`-Objekte. Verwenden Sie eine `PayoutMethod`-ID, um eine Auszahlung über die [Outbound Payments API](https://docs.stripe.com/api/v2/money-management/outbound-payments/create.md?api-version=preview) vorzunehmen. Weitere Informationen finden Sie unter [Geld senden](https://docs.stripe.com/global-payouts/send-money.md).