# Mise à jour des codes d’erreur pour l’API Outbound Setup Intents ## Nouveautés Cette mise à jour harmonise les [codes d’erreur](https://docs.stripe.com/api/errors.md?api-version=2026-01-28.preview#errors-code) renvoyés par l’API [Outbound Setup Intents](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents.md?api-version=2026-01-28.preview) sortants en privilégiant des types d’erreurs plus génériques, au lieu de codes propres à chaque type d’identifiants. Elle remplace ainsi plusieurs codes d’erreur existants par des types d’erreurs standardisés : - Les erreurs `blocked_payout_method_bank_account`, `blocked_payout_method_card bancaire` et `blocked_payout_method_card` renvoient désormais `blocked_payout_method_card`. - Les erreurs `unsupported_virement_method_bank_account` et `unsupported_virement_method_card` renvoient désormais `unsupported_payout_method`. - Les erreurs `invalid_payout_method_bank_account`, `invalid_payout_method_card` et `invalid_payout_method_crypto_wallet` renvoient désormais `invalid_payout_method`. - Les erreurs `limit_payout_method_bank_account`, `limit_payout_method_card` et `limit_payout_method_crypto_wallet` renvoient désormais `limit_payout_method`. Cette standardisation améliore la cohérence de la gestion des erreurs entre les différents types de [méthodes de virement](https://docs.stripe.com/api/v2/money-management/payout-methods.md?api-version=2026-01-28.preview) et facilite l’évolutivité future lors de l’ajout de nouveaux types d’identifiants aux méthodes de virement. ## Pourquoi s’agit-il d’une modification majeure ? Il s’agit d’une modification majeure, car votre intégration peut s’appuyer sur les identifiants spécifiques des codes d’erreur que cette mise à jour remplace. Si votre code vérifie des codes d’erreur spécifiques à un type, tels que `blocked_payout_method_bank_account`, `unsupported_payout_method_bank_account`, `invalid_payout_method_bank_account_` ou `limit_payout_method_bank_account`, ces vérifications ne fonctionneront plus : vous devez les mettre à jour afin de gérer les types d’erreurs génériques. ## Impact Si votre intégration gère des codes d’erreur spécifiques provenant des endpoints Outbound Setup Intents, vous devez mettre à jour votre logique de gestion des erreurs afin d’utiliser les types d’erreurs génériques. Les messages d’erreur et les raisons sous-jacentes restent inchangés, mais les identifiants des codes d’erreur ont été modifiés afin d’être plus cohérents entre les différents types de méthodes de virement. ## Modifications #### REST API | Codes | Change | | | ---------------------------------------------------- | ------ | ----------------------- | | `blocked_payout_method`, `unsupported_payout_method` | Added | `blocked_by_stripe` | | `invalid_payout_method_data` | Added | `invalid_payout_method` | | `limit_payout_method` | Added | `quota_exceeded` | #### Ruby Cette modification n’affecte pas le SDK Ruby. #### Python | Codes | Change | | | ---------------------------------------------------- | ------ | -------------------------- | | `blocked_payout_method`, `unsupported_payout_method` | Added | `BlockedByStripeError` | | `invalid_payout_method_data` | Added | `InvalidPayoutMethodError` | | `limit_payout_method` | Added | `QuotaExceededError` | #### PHP Cette modification n’affecte pas le SDK PHP. #### Java Cette modification n’affecte pas le SDK Java. #### Node.js | Codes | Change | | | ---------------------------------------------------- | ------ | -------------------------- | | `blocked_payout_method`, `unsupported_payout_method` | Added | `BlockedByStripeError` | | `invalid_payout_method_data` | Added | `InvalidPayoutMethodError` | | `limit_payout_method` | Added | `QuotaExceededError` | #### Go | Codes | Change | | | ---------------------------------------------------- | ------ | -------------------------- | | `blocked_payout_method`, `unsupported_payout_method` | Added | `BlockedByStripeError` | | `invalid_payout_method_data` | Added | `InvalidPayoutMethodError` | | `limit_payout_method` | Added | `QuotaExceededError` | #### .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 : 2026-01-28.preview` 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 la dernière version. 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 la dernière version. 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 la dernière version. 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 la dernière version. 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 la dernière version. 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 la dernière version. 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 la dernière version. 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). ## Modifications connexes - [Ajout d’un champ de référence alternatif aux ressources des comptes bancaires et des moyens de virement](https://docs.stripe.com/changelog/clover/2026-01-28/alternative-reference-field.md) - [Ajout de la propriété empreinte d’identification aux moyens de virement par carte bancaire](https://docs.stripe.com/changelog/clover/2026-01-28/card-payout-methods-fingerprint-property.md) - [Global Payouts prend désormais en charge 15 nouveaux pays pour les virements transfrontaliers.](https://docs.stripe.com/changelog/clover/2026-01-28/cross-border-payouts-new-countries.md)