# Fügt neue Fehlercodes für erforderliche Verifizierungen hinzu ## Das ändert sich Fügt den folgenden Fehlercode zum Array `requirements.errors` in der [Accounts API](https://docs.stripe.com/api/accounts/object.md?api-version=2025-03-31.basil#account_object-requirements-errors-code), [Capabilities API](https://docs.stripe.com/api/capabilities/object.md?api-version=2025-03-31.basil#capability_object-requirements-errors-code), [Persons API](https://docs.stripe.com/api/persons/object.md?api-version=2025-03-31.basil#person_object-requirements-errors-code) und [Bank Accounts API](https://docs.stripe.com/api/external_account_bank_accounts/object.md?api-version=2025-03-31.basil#account_bank_account_object-requirements-errors-code) hinzu. - `information_missing` - `invalid_signator` - `verification_failed_authorizer_authority` - `verification_rejected_ownership_exemption_reason` Der Fehlercode `information_missing` ist allgemeiner als frühere Fehlercodes. Verwenden Sie die verknüpften Felder `requirement` and `reason`, um zu erfahren, welche Informationen fehlen. Für einige Konten in Singapur wird beispielsweise Folgendes angezeigt: ```json // GET /v1/accounts/{{CONNECTED_ACCOUNT_ID}} { ... "requirements": { "currently_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "errors": [ { "code": "information_missing", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "We identified that your business is owned by holding companies that require additional information to be collected. Please provide documents that include information for each applicable holding company. For more information, see https://support.stripe.com/questions/beneficial-ownership-verification-for-holding-companies. The new holding companies we have identified are: ACME INC." } ], ... }, ... } ``` Wir geben den Fehler `invalid_signator` zurück, wenn Sie ein [Bescheinigungsschreiben](https://support.stripe.com/questions/singapore-ultimate-beneficial-ownership-and-director-requirements) als Nachweis für die letztendliche wirtschaftliche Eigentümerschaft hochgeladen haben und wir die Berufsorganisation, die das Dokument notariell beglaubigt hat, nicht verifizieren konnten. ```json { ... "requirements": { "currently_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "errors": [ { "code": "invalid_signator", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "We could not verify the professional certifying body of this document." } ], ... }, ... } ``` Wir geben den Fehler `verification_failed_authorizer_authority` zurück, wenn Sie eine Person als [Autorisierer](https://docs.stripe.com/api/persons/update.md?api-version=2025-03-31.basil#update_person-relationship-authorizer) in Ihrem Konto benannt haben und wir ihre Autoritätsposition innerhalb Ihres Unternehmens nicht verifizieren konnten. Weitere Informationen finden Sie unter [Verifizierung der Vertretungsbefugnis](https://support.stripe.com/questions/representative-authority-verification). ```json { ... "requirements": { "currently_due": ["{{AUTHORIZER_PERSON_TOKEN}}.relationship.authorizer"], "errors": [ { "code": "verification_failed_authorizer_authority", "requirement": "{{AUTHORIZER_PERSON_TOKEN}}.relationship.authorizer", "reason": "The authority of the authorizer could not be verified. Authorizers must be one of Director, Chief Executive Officer listed on acra.gov.sg." } ], ... }, ... } ``` Wir geben den Fehler `verification_rejected_ownership_exemption_reason` zurück, wenn Sie eine Ausnahme für die Bereitstellung Ihrer letztendlichen wirtschaftlichen Eigentumsverhältnisse eingereicht haben, und wir die Ausnahme abgelehnt haben. ```json { ... "requirements": { "currently_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "alternatives": [ { "original_fields_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "alternative_fields_due": ["company.ownership_exemption_reason"], } ], "errors": [ { "code": "verification_rejected_ownership_exemption_reason", "requirement": "company.ownership_exemption_reason", "reason": "The ownership exemption reason was rejected." } ], ... }, ... } ``` ## Warum ist dies eine wichtige Änderung? Einige Connect-Integrationen erfordern möglicherweise ein Update, um die neuen Fehlercodes zu verarbeiten. ## Ergebnis Sie können neue Fehlercodes für die [anstehenden Aktualisierungen der Anforderungen](https://docs.stripe.com/connect/upcoming-requirements-updates.md?program=sg-2023) in Singapur verarbeiten. ## Änderungen #### REST API | Values | Change | Enums | | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, `verification_rejected_ownership_exemption_reason` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2025-03-31.basil#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2025-03-31.basil#account_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-requirements), [Capability.future_requirements.errors[].code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-future_requirements-errors-code), [Capability.requirements.errors[].code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-requirements-errors-code), [Person.future_requirements.errors[].code](/api/persons/object?api-version=2025-03-31.basil#person_object-future_requirements-errors-code), [Person.requirements.errors[].code](/api/persons/object?api-version=2025-03-31.basil#person_object-requirements-errors-code) | #### Ruby Diese Änderung wirkt sich nicht auf das Ruby SDK aus. #### Python | Values | Change | Enums | | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, `verification_rejected_ownership_exemption_reason` | Added | [Account.FutureRequirement.Error.code](/api/accounts/object?api-version=2025-03-31.basil#account_object-future_requirements-errors-code), [Account.Requirement.Error.code](/api/accounts/object?api-version=2025-03-31.basil#account_object-requirements-errors-code), [AccountCapability.FutureRequirement.Error.code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-future_requirements-errors-code), [AccountCapability.Requirement.Error.code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-requirements-errors-code), [AccountPerson.FutureRequirement.Error.code](/api/persons/object?api-version=2025-03-31.basil#person_object-future_requirements-errors-code), [AccountPerson.Requirement.Error.code](/api/persons/object?api-version=2025-03-31.basil#person_object-requirements-errors-code), [BankAccount.FutureRequirement.Error.code](/api/accounts/object?api-version=2025-03-31.basil#account_object-future_requirements-errors-code), [BankAccount.Requirement.Error.code](/api/accounts/object?api-version=2025-03-31.basil#account_object-requirements-errors-code) | #### PHP Diese Änderung wirkt sich nicht auf das PHP SDK aus. #### Java Diese Änderung wirkt sich nicht auf das Java SDK aus. #### Node.js | Values | Change | Enums | | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, `verification_rejected_ownership_exemption_reason` | Added | [Account.future_requirements.errors[].code](/api/accounts/object?api-version=2025-03-31.basil#account_object-future_requirements-errors-code), [Account.requirements.errors[].code](/api/accounts/object?api-version=2025-03-31.basil#account_object-requirements-errors-code), [AccountCapability.future_requirements.errors[].code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-future_requirements-errors-code), [AccountCapability.requirements.errors[].code](/api/capabilities/object?api-version=2025-03-31.basil#capability_object-requirements-errors-code), [AccountPerson.future_requirements.errors[].code](/api/persons/object?api-version=2025-03-31.basil#person_object-future_requirements-errors-code), [AccountPerson.requirements.errors[].code](/api/persons/object?api-version=2025-03-31.basil#person_object-requirements-errors-code), [BankAccount.future_requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-future_requirements-errors-code), [BankAccount.requirements.errors[].code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-requirements) | #### Go | Values | Change | Enums | | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, `verification_rejected_ownership_exemption_reason` | Added | [BankAccountFutureRequirementsErrors.Code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-future_requirements-errors-code), [BankAccountRequirementsErrors.Code](/api/external_account_bank_accounts/object?api-version=2025-03-31.basil#account_bank_account_object-requirements-errors-code) | #### .NET Diese Änderung wirkt sich nicht auf das .NET SDK aus. ## Upgrade #### REST API 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 1. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version. - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2025-03-31.basil` 1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 1. Aktualisieren Sie Ihr Ruby SDK auf [v15.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.0.0) 1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 1. Aktualisieren Sie Ihr Python SDK auf [v12.0.0](https://github.com/stripe/stripe-python/releases/tag/v12.0.0) 1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 1. Aktualisieren Sie Ihr PHP SDK auf [v17.0.0](https://github.com/stripe/stripe-php/releases/tag/v17.0.0) 1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 1. Aktualisieren Sie Ihr Java SDK auf [v29.0.0](https://github.com/stripe/stripe-java/releases/tag/v29.0.0) 1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 1. Aktualisieren Sie Ihr Node SDK auf [v18.0.0](https://github.com/stripe/stripe-node/releases/tag/v18.0.0) 1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 1. Aktualisieren Sie Ihr Go SDK auf [v82.0.0](https://github.com/stripe/stripe-go/releases/tag/v82.0.0) 1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 1. Aktualisieren Sie Ihr .NET SDK auf [v48.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.0.0) 1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).