# Ajout de nouveaux codes d’erreur pour les vérifications requises ## Nouveautés Ajoute les codes d’erreur suivants au tableau `requirements.errors` dans les [API Accounts](https://docs.stripe.com/api/accounts/object.md?api-version=2025-03-31.basil#account_object-requirements-errors-code), [API Capabilities](https://docs.stripe.com/api/capabilities/object.md?api-version=2025-03-31.basil#capability_object-requirements-errors-code), [API Persons](https://docs.stripe.com/api/persons/object.md?api-version=2025-03-31.basil#person_object-requirements-errors-code) et [API Bank 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). - `information_missing` - `invalid_signator` - `verification_failed_authorizer_authority` - `verification_rejected_ownership_exemption_reason` Le code d’erreur `information_missing` est plus générique que les codes d’erreur précédents. Reportez-vous aux champs `requirement` et `reason` associés pour savoir quelles informations sont manquantes. Par exemple, certains comptes établis à Singapour peuvent voir : ```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." } ], ... }, ... } ``` Nous renvoyons l’erreur `invalid_signator` si vous avez chargé une [lettre d’autorisation](https://support.stripe.com/questions/singapore-ultimate-beneficial-ownership-and-director-requirements) en guise de document de preuve de bénéficiaire effectif et que nous n’avons pas pu vérifier l’organisme professionnel qui a authentifié le document. ```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." } ], ... }, ... } ``` Nous renvoyons l’erreur `verification_failed_authorizer_authority` si vous avez désigné une personne comme [autorisateur](https://docs.stripe.com/api/persons/update.md?api-version=2025-03-31.basil#update_person-relationship-authorizer) sur votre compte et que nous n’avons pas pu vérifier sa position d’autorité au sein de votre entreprise. Pour en savoir plus, consultez la page [vérification de l’autorité](https://support.stripe.com/questions/representative-authority-verification) du représentant. ```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." } ], ... }, ... } ``` Nous renvoyons l’erreur `verification_rejected_ownership_exemption_reason` si vous avez soumis une exemption à la saisie des bénéficiaires effectifs finaux et que nous avons rejeté la demande d’exemption. ```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." } ], ... }, ... } ``` ## Pourquoi s’agit-il d’une modification majeure ? Certaines intégrations Connect peuvent nécessiter une mise à jour pour gérer les nouveaux codes d’erreur. ## Impact Vous pourrez gérer les nouveaux codes d’erreur relatifs à [l’évolution prochaine des exigences](https://docs.stripe.com/connect/upcoming-requirements-updates.md?program=sg-2023) à Singapour. ## Modifications #### API REST | 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 Cette modification n’affecte pas le SDK Ruby. #### 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 Cette modification n’affecte pas le SDK PHP. #### Java Cette modification n’affecte pas le SDK Java. #### 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 Cette modification n’affecte pas le SDK .NET. ## Mise à niveau #### API REST 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API. - Si vous n’utilisez pas de SDK, mettez à jour vos [requêtes API](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2025-03-31.basil` 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Ruby 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Ruby vers [v15.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.0.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Python 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Python vers [v12.0.0](https://github.com/stripe/stripe-python/releases/tag/v12.0.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### PHP 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK PHP vers [v17.0.0](https://github.com/stripe/stripe-php/releases/tag/v17.0.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Java 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Java vers [v29.0.0](https://github.com/stripe/stripe-java/releases/tag/v29.0.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Node.js 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Node vers [v18.0.0](https://github.com/stripe/stripe-node/releases/tag/v18.0.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### Go 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK Go vers [v82.0.0](https://github.com/stripe/stripe-go/releases/tag/v82.0.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md). #### .NET 1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench. 1. Mettez à niveau votre SDK .NET vers [v48.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.0.0) 1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md). 1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version. 1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md). 1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures. En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).