# Testen der Kontobestätigung beim API-Onboarding Eine exemplarische Vorgehensweise zum Testen verschiedener Verifizierungsstatus für verbundene Konten beim API-Onboarding mit Ihrem Test-API-Schlüssel. # Accounts v2 > This is a Accounts v2 for when accounts-namespace is v2. View the full page at https://docs.stripe.com/connect/testing-verification?accounts-namespace=v2. In diesem Dokument wird davon ausgegangen, dass Sie mit dem [API-Onboarding](https://docs.stripe.com/connect/api-onboarding.md) vertraut sind und wissen, wie Sie [Konten aktualisieren](https://docs.stripe.com/connect/updating-service-agreements.md) und die [Identitätsprüfung](https://docs.stripe.com/connect/identity-verification.md) durchführen. Testen Sie Ihre Verifizierungsabläufe, damit sie die Änderungen am Kontostatus handhaben können (z. B. wenn Sie Zahlungen aktivieren oder deaktivieren). Kontostatus ändern sich in der Regel, nachdem die Anforderungen erfüllt sind oder wenn Verarbeitungs- oder Zeitschwellenwerte erreicht werden. In den nachfolgenden Abschnitten werden diese Änderungen beschrieben, und es wird erläutert, wie Sie Ihre Verifizierungsabläufe testen können. ## Ursprüngliche Anforderungen testen Erstellen Sie zunächst ein neues verbundenes Konto in einer *Sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), fügen Sie ein Bankkonto hinzu und weisen Sie nach, dass der Kontoinhaber/die Kontoinhaberin den Stripe-Rahmenvertrag akzeptiert hat. Stripe verlangt, dass das verbundene Konto den [Rahmenvertrag von Stripe](https://docs.stripe.com/connect/updating-service-agreements.md#tos-acceptance) explizit akzeptiert, bevor Auszahlungen getätigt werden. In diesem Beispiel ist der `identity.entity_type` auf `company` festgelegt und `external_account` nutzt ein mit Token versehenes Stripe-Testkonto als Erinnerung, um zu vermeiden, dass sensible Informationen in den API-Aufrufen offengelegt werden. > Sie müssen einen Test-API-Schlüssel eines Stripe-Kontos, mit dem das Connect-Plattform-Onboarding begonnen hat. Der automatisch ausgefüllte Stripe-Test-API-Schlüssel führt dazu, dass diese Beispielanfragen fehlschlagen. Wenn Sie das `Account` erstellen, müssen Sie das `identity.country` festlegen und die Funktionen `card_payments` und `stripe_balance.stripe_transfers` anfordern. Die folgenden Beispiele zeigen ein plattformgesteuertes Konto mit der Konfiguration `merchant` und `recipient`. ```curl curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2025-11-17.preview" \ --json '{ "identity": { "country": "US", "entity_type": "company", "attestations": { "terms_of_service": { "account": { "date": "2019-01-19T19:51:13Z", "ip": "172.18.80.19" } } } }, "dashboard": "none", "defaults": { "responsibilities": { "losses_collector": "application", "fees_collector": "stripe" }, "currency": "usd" }, "configuration": { "merchant": { "capabilities": { "card_payments": { "requested": true } } }, "recipient": { "capabilities": { "stripe_balance": { "stripe_transfers": { "requested": true } } } } } }' ``` Zu diesem Zeitpunkt ist das Konto erstellt, Zahlungen und*Auszahlungen* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) sind jedoch erst aktiviert, wenn Sie die Verifizierungsanforderungen erfüllen und eine Auszahlungsmethode beifügen. Überprüfen Sie das Array `requirements.entries`, um die Informationen zu ermitteln, die Sie erfassen müssen. Derzeit erforderliche Einträge haben den `minimum_deadline.status` `currently_due`. ```json { "id": "{% identifier type=\"connectedAccount\" quoteType=\"double\" /%}", "object": "account", "identity": { "country": "US", "entity_type": "company" }, "dashboard": "none", "defaults": { "responsibilities": { "losses_collector": "application", "fees_collector": "stripe" }, "currency": "usd" }, "configuration": { "merchant": { "capabilities": { "card_payments": { "status": "restricted", "status_details": [ { "code": "determining_status", "resolution": "provide_info" } ] } } }, "recipient": { "capabilities": { "transfers": { "status": "restricted", "status_details": [ { "code": "determining_status", "resolution": "provide_info" } ] } } } }, "requirements": { "summary": { "minimum_deadline": { "time": 1700000000, "status": "currently_due" } }, "entries": [ { "id": "reqent_1", "description": "configuration.merchant.mcc", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_2", "description": "defaults.profile.business_url", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_3", "description": "identity.business_details.address.city", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_4", "description": "identity.business_details.address.line1", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_5", "description": "identity.business_details.address.postal_code", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_6", "description": "identity.business_details.address.state", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_7", "description": "identity.business_details.registered_name", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_8", "description": "identity.business_details.phone", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_9", "description": "identity.business_details.id_numbers.us_ein", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_10", "description": "relationship.representative", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] }, { "id": "reqent_11", "description": "relationship.owner", "minimum_deadline": { "status": "currently_due" }, "awaiting_action_from": "user", "errors": [] } ] } } ``` Anschließend können Sie die in der Antwort angegebenen erforderlichen Informationen erfassen und dem Account-Objekt hinzufügen. ```curl curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}} \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2025-11-17.preview" \ --json '{ "defaults": { "profile": { "business_url": "https://bestcookieco.com" } }, "identity": { "business_details": { "address": { "city": "Schenectady", "line1": "123 State St", "postal_code": "12345", "state": "NY" }, "id_numbers": [ { "type": "us_ein", "value": "000000000" } ], "phone": "8888675309", "registered_name": "The Best Cookie Co" } } }' ``` Nach dem Aktualisieren der Unternehmensdaten können sich die Anforderungseinträge ändern. Für `Person`-Anforderungen müssen Sie unter dem `Account`-Objekt `Person`-Objekte für die Personen erstellen und aktualisieren, die Vertreter/innen oder Inhaber/innen des Unternehmens sind. Verwenden Sie die [Persons](https://docs.stripe.com/api/v2/core/persons.md?api-version=2025-11-17.preview)-API, um ein Profil für die Person zu erstellen, die Inhaber/in oder Vertreter/in des Kontos ist. In diesem Beispiel erstellen wir ein Profil für Jenny Rosen und kennzeichnen sie als `representative` mit dem `title` `CEO`. ```curl curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}}/persons \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2025-11-17.preview" \ --json '{ "given_name": "Jenny", "surname": "Rosen", "relationship": { "representative": true, "title": "CEO" } }' ``` > Bei Konten, deren [business_type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) auf `individual` festgelegt ist, geben Sie mindestens eine `individual`-Eigenschaft an (zum Beispiel `individual.first_name`) und ein [Person](https://docs.stripe.com/api/persons/object.md)-Objekt wird automatisch erstellt. Wenn Sie dies nicht durchführen oder für Konten, deren `business_type` auf `company` festgelegt ist, müssen Sie [jede Person](https://docs.stripe.com/api/persons/create.md) für das Konto erstellen. Wenn Sie eine `Person` erstellen, enthält die Antwort einen `requirements.entries`-Hash. Dieser führt die erforderlichen Verifizierungsinformationen für die jeweilige Person auf. ```json { "id": "person_abc", "object": "person", "requirements": { "entries": [ { "id": "p_req_1", "description": "representative.address.city", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_2", "description": "representative.address.line1", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_3", "description": "representative.address.postal_code", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_3", "description": "representative.address.state", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, `` { "id": "p_req_4", "description": "representative.date_of_birth.day", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_5", "description": "representative.date_of_birth.month", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_6", "description": "representative.date_of_birth.year", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_7", "description": "representative.phone", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_8", "description": "representative.email", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_9", "description": "identity.attestations.persons_provided.owners", "minimum_deadline": { "status": "currently_due" }, "errors": [] }, { "id": "p_req_10", "description": "representative.id_numbers. us_ssn_last_4", "minimum_deadline": { "status": "currently_due" }, "errors": [] } ] } } ``` Nachdem Sie eine `Person` erstellt und die angeforderten Angaben zur Person gemacht haben, enthält `requirements.entries` des Kontos Beschreibungen, die auf die [Personen-ID](https://docs.stripe.com/api/v2/core/persons/object.md?api-version=2025-11-17.preview#v2_person_object-id) verweisen. [Aktualisieren Sie die Person](https://docs.stripe.com/api/v2/core/persons/update.md?api-version=2025-11-17.preview), um die angeforderten Verifizierungsinformationen für Jenny Rosen bereitzustellen: ```curl curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}}/persons/{{PERSON_ID}} \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2025-11-17.preview" \ --json '{ "address": { "city": "Schenectady", "line1": "123 State St", "postal_code": "12345", "state": "NY" }, "date_of_birth": { "day": 10, "month": 11, "year": 1980 }, "id_numbers": [ { "type": "us_ssn_last_4", "value": "0000" } ], "phone": "8888675309", "email": "jenny@example.com", "relationship": { "executive": true } }' ``` Indem Sie `relationship.executive` als True festlegen, versichern Sie gegenüber Stripe, dass es der Vertreter/die Vertreterin eine maßgebliche Führungsrolle innerhalb der Organisation innehat. Unter [für die USA erforderlichen Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md#additional-company-card-representative-us) finden Sie weitere Informationen zu den Details zur Verifizierung von Unternehmensvertretern/-vertreterinnen für US-Unternehmen. Um einen Inhaber/eine Inhaberin hinzuzufügen, erstellen Sie eine weitere `Person` und kennzeichnen Sie ihn/sie als `owner` des Kontos. In diesem Beispiel besitzt Kathleen Banks 80 % von The Best Cookie Co. ```curl curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}}/persons \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2025-11-17.preview" \ --json '{ "given_name": "Kathleen", "surname": "Banks", "email": "kathleen@example.com", "relationship": { "owner": true, "percent_ownership": "80" } }' ``` Sie müssen alle Inhaber/innen hinzufügen, die mindestens 25 % des Unternehmens besitzen, und anschließend `identity.attestations.persons_provided.owners` auf True setzen. ```curl curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTEDACCOUNT_ID}} \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2025-11-17.preview" \ --json '{ "identity": { "attestations": { "persons_provided": { "owners": true } } } }' ``` Ein erfolgreiches Onboarding Ihres verbundenes Konto in dieser Phase bedeutet: - Sie haben alle erforderlichen Informationen angegeben (`requirements.summary.minimum_deadline=null`). - Zahlungen für das Konto (`charges_enabled=true`) aktiviert werden. - Sie haben ein `v2.core.account.updated` *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests)-Ereignis von Stripe erhalten. ## Testschwellen Unabhängig davon, ob Sie *Upfront-Onboarding* oder *inkrementelles Onboarding* verwenden, kann Stripe weitere Informationen über verbundene Konten anfordern, sobald bestimmte Schwellenwerte erreicht sind. Beispielsweise können nach einem Transaktionsvolumen in Höhe von 1.500 USD oder 30 Tagen nach der Kontoerstellung weitere Informationen erforderlich sein. Um herauszufinden, welche Informationen möglicherweise später erforderlich werden, sobald ein Konto einen Schwellenwert erreicht, überprüfen Sie das Array `requirements.entries` auf Anforderungen mit `minimum_deadline.status` `eventually_due`. Wenn Sie die erforderlichen Informationen nicht bis zu einem bestimmten Datum bereitstellen, werden Zahlungen und Auszahlungen möglicherweise deaktiviert. Sie können diese Szenarien zu Testzwecken auslösen. ### Auslöseschwellen Sie können mit dem [Verifizierungs](https://docs.stripe.com/connect/testing.md#trigger-cards)-Token (`tok_visa_triggerVerification`) eine Zahlung erstellen, um einen allgemeinen Verifizierungsgrenzwert auszulösen. Dadurch werden weder Zahlungen noch Auszahlungen blockiert, jedoch wird die Anforderung zusätzlicher Informationen ausgelöst. Wenn Sie das Webhook-Ereignis [v2.core.account[requirements].updated](https://docs.stripe.com/api/v2/core/accounts/event-types.md?api-version=2025-11-17.preview#v2_accounts_event_types-v2.core.account%5Brequirements%5D.updated) beobachten, können Sie Folgendes prüfen: - `requirements.entries` für Einträge, deren `minimum_deadline.status` `currently_due` ist - `requirements.summary.minimum_deadline.time`, um die früheste Frist für diese Einträge zu ermitteln Um Szenarien zu testen, in denen die erforderlichen Informationen nicht fristgerecht bereitgestellt werden, finden Sie in den Abschnitten [Zahlungen](https://docs.stripe.com/connect/testing-verification.md#blocked-charges) und [Auszahlungen](https://docs.stripe.com/connect/testing-verification.md#blocked-payouts) blockieren weiter unten. Sie können auch spezifischere Verifizierungsauslöser auslösen, wie z. B. [Identität stimmt nicht überein](https://docs.stripe.com/connect/testing.md#test-personal-id-numbers) oder [OFAC-Schwelle](https://docs.stripe.com/connect/testing.md#test-dobs). Das Testen dieser Szenarien ist sinnvoll, da sie häufig auftreten, wenn die Verifizierung fehlschlägt. ### Blockierte Zahlungen testen Sie können Zahlungen blockieren, indem Sie mit dem Token [Zahlung blockieren](https://docs.stripe.com/connect/testing.md#trigger-cards) (`tok_visa_triggerChargeBlock`) eine Testzahlung erstellen. Anschließend sollten Sie das Webhook-Ereignis [v2.core.account[requirements].updated](https://docs.stripe.com/api/v2/core/accounts/event-types.md?api-version=2025-11-17.preview#v2_accounts_event_types-v2.core.account%5Brequirements%5D.updated) erhalten, das Folgendes anzeigt: - Der Status der relevanten Funktion für Kartenzahlungen ist nicht `aktiv` (zum Beispiel ist `configuration.merchant.capabilities.card_payments.status` nicht `aktiv`) - Erforderliche Informationen im Array `requirements.entries` (mit `minimum_deadline.status` und `currently_due`) - Alle Einträge, die noch nicht erforderlich sind, werden als `minimum_deadline.status` und `eventually_due` angezeigt Sie können dann [das Konto aktualisieren](https://docs.stripe.com/api/v2/core/accounts/update.md?api-version=2025-11-17.preview) und die neuen Informationen hinzufügen. Dadurch wird ein weiteres Webhook-Ereignis ausgelöst, das anzeigt, dass Zahlungen aktiviert sind und derzeit keine fälligen oder irgendwann fälligen Anforderungen vorliegen. ### Blockierte Auszahlungen testen Sie können Auszahlungen blockieren, indem Sie eine Testzahlung mit dem [block transfer](https://docs.stripe.com/connect/testing.md#trigger-cards)-Token (`tok_visa_triggerTransferBlock`) erstellen. Anschließend sollten Sie das Webhook-Ereignis `v2.core.account.updated` erhalten, das Folgendes anzeigt: - `capabilities.stripe_balance.payouts.status` in der Konfiguration `Händler/in` oder `Empfänger/in` ist nicht `aktiv` - Derzeit erforderliche Informationen im Array `requirements.entries` mit `minimum_deadline.status` von `currently_due` - Schließlich erforderliche Anforderungen im Array `requirements.entries` mit `minimum_deadline.status` von `eventually_due` Sie können das Konto mit neuen Informationen [aktualisieren](https://docs.stripe.com/api/v2/core/accounts/update.md?api-version=2025-11-17.preview). Dadurch wird ein weiteres Webhook-Ereignis ausgelöst, das signalisiert, dass Auszahlungen aktiviert sind und dass die Arrays `requirements.summary` and `requirements.summary.minimum_deadline` leer sind. # Accounts v1 > This is a Accounts v1 for when accounts-namespace is v1. View the full page at https://docs.stripe.com/connect/testing-verification?accounts-namespace=v1. In diesem Dokument wird davon ausgegangen, dass Sie mit dem [API-Onboarding](https://docs.stripe.com/connect/api-onboarding.md) vertraut sind und wissen, wie Sie [Konten aktualisieren](https://docs.stripe.com/connect/updating-service-agreements.md) und die [Identitätsprüfung](https://docs.stripe.com/connect/identity-verification.md) durchführen. Testen Sie Ihre Verifizierungsabläufe, damit sie die Änderungen am Kontostatus handhaben können (z. B. wenn Sie Zahlungen aktivieren oder deaktivieren). Kontostatus ändern sich in der Regel, nachdem die Anforderungen erfüllt sind oder wenn Verarbeitungs- oder Zeitschwellenwerte erreicht werden. In den nachfolgenden Abschnitten werden diese Änderungen beschrieben, und es wird erläutert, wie Sie Ihre Verifizierungsabläufe testen können. ## Ursprüngliche Anforderungen testen Beginnen Sie, indem Sie ein neues verbundenes Konto in einer *Sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) erstellen, ein Bankkonto hinzufügen und zeigen, dass der/die Kontoinhaber/in dem Stripe-Rahmenvertrag zugestimmt hat. Stripe verlangt, dass das verbundene Konto vor der Durchführung von Auszahlungen dem [Rahmenvertrag von Stripe](https://docs.stripe.com/connect/updating-service-agreements.md#tos-acceptance) ausdrücklich zustimmt. In diesem Beispiel wird `business_type` auf `company` eingestellt, um ein komplexeres Szenario zu veranschaulichen, und `external_account` verwendet ein tokenisiertes Stripe-Testkonto als Erinnerung dafür, dass in API-Aufrufen keine sensiblen Informationen preisgegeben werden. > Sie müssen einen Test-API-Schlüssel eines Stripe-Kontos, mit dem das Connect-Plattform-Onboarding begonnen hat. Der automatisch ausgefüllte Stripe-Test-API-Schlüssel führt dazu, dass diese Beispielanfragen fehlschlagen. Sie können ein verbundenes Konto entweder mit den Controller-Eigenschaften oder durch Festlegen des Kontotyps erstellen. In beiden Fällen müssen Sie das Land festlegen und die Funktionen `card_payments` und `transfers` anfordern. #### Mit Controllereigenschaften ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d country=US \ -d "controller[losses][payments]"=application \ -d "controller[fees][payer]"=application \ -d "controller[stripe_dashboard][type]"=none \ -d "controller[requirement_collection]"=application \ -d business_type=company \ -d "capabilities[card_payments][requested]"=true \ -d "capabilities[transfers][requested]"=true \ -d external_account=btok_us \ -d "tos_acceptance[date]"=1547923073 \ -d "tos_acceptance[ip]"="172.18.80.19" ``` #### Mit Kontotyp ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d country=US \ -d type=custom \ -d business_type=company \ -d "capabilities[card_payments][requested]"=true \ -d "capabilities[transfers][requested]"=true \ -d external_account=btok_us \ -d "tos_acceptance[date]"=1547923073 \ -d "tos_acceptance[ip]"="172.18.80.19" ``` An dieser Stelle wird das Konto erstellt, Zahlungen und *Auszahlungen* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) sind jedoch weiterhin deaktiviert. Überprüfen Sie in der Antwort das Array `requirements.currently_due`, um zu bestimmen, welche Informationen erfasst werden müssen: ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "requirements": { "currently_due": [ "business_profile.mcc", "business_profile.url", "company.address.city", "company.address.line1", "company.address.postal_code", "company.address.state", "company.name", "company.phone", "company.tax_id", "relationship.representative", "relationship.owner" ], ... }, ... } ``` Verwenden Sie dann die in der Antwort zurückgegebene `id` des externen Kontos, um das Konto mit den zusätzlichen erforderlichen Kontoangaben zu aktualisieren: ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "business_profile[mcc]"=5045 \ --data-urlencode "business_profile[url]"="https://bestcookieco.com" \ -d "company[address][city]"=Schenectady \ -d "company[address][line1]"="123 State St" \ -d "company[address][postal_code]"=12345 \ -d "company[address][state]"=NY \ -d "company[tax_id]"=000000000 \ -d "company[name]"="The Best Cookie Co" \ -d "company[phone]"=8888675309 ``` Nach erfolgreicher Aktualisierung der Unternehmensdetails zeigt die Überprüfung von `requirements.currently_due`, dass die `relationship`-Anforderungen weiterhin erforderlich sind: ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "requirements": { "currently_due": [ "relationship.representative", "relationship.owner", ], ... }, ... } ``` Verwenden Sie die [Persons](https://docs.stripe.com/api/persons.md) API, um ein Profil für die Person zu erstellen, die die Beziehung zum Konto repräsentiert. In diesem Beispiel erstellen wir ein Profil für Jenny Rosen und kennzeichnen sie als `representative`. In diesem Beispiel haben wir außerdem das optionale Attribut `title` ausgefüllt. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "relationship[representative]"=true \ -d "relationship[title]"=CEO ``` > Bei Konten, deren [business_type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) auf `individual` festgelegt ist, geben Sie mindestens eine `individual`-Eigenschaft an (zum Beispiel `individual.first_name`) und ein [Person](https://docs.stripe.com/api/persons/object.md)-Objekt wird automatisch erstellt. Wenn Sie dies nicht durchführen oder für Konten, deren `business_type` auf `company` festgelegt ist, müssen Sie [jede Person](https://docs.stripe.com/api/persons/create.md) für das Konto erstellen. Wenn Sie eine `Person` erstellen, enthält die Antwort einen `requirements`-Hash. Dieser führt die erforderlichen Verifizierungsinformationen für die jeweilige Person auf. ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "requirements": { "currently_due": [ "address.city", "address.line1", "address.postal_code", "address.state", "dob.day", "dob.month", "dob.year", "phone", "email", "relationship.executive", "ssn_last_4" ], ... }, ... } ``` Nachdem Sie eine `Person` für Ihr externes Konto erstellt haben, wird durch Überprüfen des `Account`-Objekts festgestellt, dass die erforderlichen Verifizierungsinformationen für die neu erstellte `Person` zur Liste `requirements.currently_due` hinzugefügt wurden: ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", "requirements": { "currently_due": [ "person.person_xxx.address.city", "person.person_xxx.address.line1", "person.person_xxx.address.postal_code", "person.person_xxx.address.state", "person.person_xxx.dob.day", "person.person_xxx.dob.month", "person.person_xxx.dob.year", "person.person_xxx.phone", "person.person_xxx.email", "person.person_xxx.relationship.executive", "person.person_xxx.ssn_last_4", "relationship.owner" ], ... }, ... } ``` Verwenden Sie die API [Aktualisieren einer Person](https://docs.stripe.com/api/persons/update.md), um die angeforderten Verifizierungsinformationen für Jenny Rosen bereitzustellen: ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons/{{PERSON_ID}} \ -u "<>:" \ -d "address[city]"=Schenectady \ -d "address[line1]"="123 State St" \ -d "address[postal_code]"=12345 \ -d "address[state]"=NY \ -d "dob[day]"=10 \ -d "dob[month]"=11 \ -d "dob[year]"=1980 \ -d ssn_last_4=0000 \ -d phone=8888675309 \ --data-urlencode email="jenny@example.com" \ -d "relationship[executive]"=true ``` Indem Sie `relationship[executive]=true` festlegen, versichern Sie gegenüber Stripe, dass es sich bei dem/der Vertreter/in um eine Person mit maßgeblicher Führungsrolle innerhalb der Organisation handelt. Unter [für die USA erforderlichen Verifizierungsinformationen](https://docs.stripe.com/connect/required-verification-information.md#additional-company-card-representative-us) finden Sie weitere Informationen zu den Details zur Verifizierung von Unternehmensvertreter/innen für US-Unternehmen. Nach der Angabe der Informationen zum `representative` muss noch der `owner` des Kontos ermittelt werden. In diesem Beispiel besitzt Kathleen Banks 80 % von The Best Cookie Co. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Kathleen \ -d last_name=Banks \ --data-urlencode email="kathleen@example.com" \ -d "relationship[owner]"=true \ -d "relationship[percent_ownership]"=80 ``` In unserem Beispiel besitzt Kathleen Banks weniger als 100 % von The Best Cookie Co. Sie haben keine weiteren Inhaber/innen festgelegt, um die Inhaberschaft auf 100 % zu vervollständigen. Stripe benötigt daher von Ihnen eine Bestätigung, dass Sie alle erforderlichen Inhaber/innen angegeben haben. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "company[owners_provided]"=true ``` Die erfolgreiche Einrichtung Ihres verbundenen Kontos in dieser Phase bedeutet, dass: - Sie haben alle erforderlichen Informationen ausgefüllt (`requirements.currently_due=null`). - Zahlungen für das Konto (`charges_enabled=true`) aktiviert werden. - Sie einen `account.updated` *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) von Stripe erhalten haben. ## Testschwellen Unabhängig davon, ob Sie *Onboarding im Voraus* (Upfront onboarding is a type of onboarding where you collect all required verification information from your users at sign-up) oder *inkrementelles Onboarding* (Incremental onboarding is a type of onboarding where you gradually collect required verification information from your users. You collect a minimum amount of information at sign-up, and you collect more information as the connected account earns more revenue) durchführen, kann Stripe bei Erreichen verschiedener Schwellenwerte weitere Informationen zu verbundenen Konten anfordern. Diese Schwellenwerte werden manchmal durch Überprüfungsfehler oder [OFAC](https://www.treasury.gov/about/organizational-structure/offices/Pages/Office-of-Foreign-Assets-Control.aspx)-Prüfungen ausgelöst. In anderen Fällen werden sie durch eine Verarbeitungs- oder Zeitkomponente ausgelöst. Beispielsweise können nach einer Zahlung von 1.500 USD oder 30 Tage nach Erstellung eines Kontos (je nachdem, was zuerst eintritt) weitere Informationen angefordert werden. Prüfen Sie das Array `requirements.eventually_due` und den Zeitstempel `requirements.current_deadline`, um herauszufinden, welche Informationen wann erforderlich sind. In einigen Fällen, wenn Sie bis zu einem bestimmten Datum keine neuen Informationen erfassen, werden Zahlungen und payouts möglicherweise deaktiviert, bis Sie diese erfassen. Sie können diese Szenarien auslösen, um diese Schwellenwerte zu testen und dann die erforderlichen Informationen zu erfassen. ### Auslöseschwellen Sie können mit dem [Verifizierungs](https://docs.stripe.com/connect/testing.md#trigger-cards)-Token (`tok_visa_triggerVerification`) eine Zahlung erstellen, um einen allgemeinen Verifizierungsgrenzwert auszulösen. Dadurch werden weder Zahlungen noch Auszahlungen blockiert, jedoch wird die Anforderung zusätzlicher Informationen ausgelöst. Wenn Sie den Webhook `account.updated` beobachten, können Sie Folgendes prüfen: - `requirements.currently_due`, um zu ermitteln, welche Informationen erforderlich sind. - `requirements.current_deadline`, um herauszufinden, wann die Informationen benötigt werden. Wenn die Informationen nicht bis zum `current_deadline` erfasst werden, können Zahlungen und Auszahlungen deaktiviert werden. Solche und ähnliche Szenarien können Sie in den nachfolgenden Abschnitten zum Blockieren von [Zahlungen](https://docs.stripe.com/connect/testing-verification.md#blocked-charges) und [Auszahlungen](https://docs.stripe.com/connect/testing-verification.md#blocked-payouts) testen. Sie können auch genauere Verifizierungsschwellen auslösen, zum Beispiel, wenn die [Identität nicht übereinstimmt](https://docs.stripe.com/connect/testing.md#test-personal-id-numbers) oder die [OFAC-Schwelle](https://docs.stripe.com/connect/testing.md#test-dobs) erreicht wird. Es ist hilfreich, diese Schwellen zu testen, da sie häufig der Grund sind, wenn die Verifizierung fehlschlägt. ### Blockierte Zahlungen testen Sie können Zahlungen blockieren, indem Sie mit dem Token [Zahlung blockieren](https://docs.stripe.com/connect/testing.md#trigger-cards) (`tok_visa_triggerChargeBlock`) eine Testzahlung erstellen. Anschließend sollten Sie den Webhook `account.updated` erhalten, der Folgendes anzeigt: - `charges_enabled=false`. - Die erforderlichen Informationen im `requirements.currently_due`-Array. - Ein leeres `requirements.eventually_due`-Array. Sie können das Konto mit neuen Informationen [aktualisieren](https://docs.stripe.com/api/accounts/update.md). Dadurch wird ein weiterer Webhook ausgelöst, der signalisiert, dass Zahlungen aktiviert sind und dass die Zeilen `requirements.currently_due` and `requirements.eventually_due` leer sind. ### Blockierte Auszahlungen testen Sie können Auszahlungen blockieren, indem Sie mit dem Token [Transfer blockieren](https://docs.stripe.com/connect/testing.md#trigger-cards) (`tok_visa_triggerTransferBlock`) eine Test-Zahlung erstellen. Anschließend sollten Sie den Webhook `account.updated` erhalten, der Folgendes anzeigt: - `payouts_enabled=false`. - Die erforderlichen Informationen im `requirements.currently_due`-Array. - Ein leeres `requirements.eventually_due`-Array. Sie können das Konto mit neuen Informationen [aktualisieren](https://docs.stripe.com/api/accounts/update.md). Dadurch wird ein weiterer Webhook ausgelöst, der signalisiert, dass Auszahlungen aktiviert sind und dass die Zeilen `requirements.currently_due` and `requirements.eventually_due` leer sind.