# Suivi des virements à l'aide d'un identifiant unique ## Nouveautés Introduit un champ [trace_id](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id) dans la ressource [virement](https://docs.stripe.com/api/payouts.md?api-version=2024-11-20.acacia) . L’[ID de suivi](https://docs.stripe.com/payouts/trace-id.md) est un identifiant unique créé par nos partenaires bancaires pour vous aider à suivre les virements manquants ou en retard. Si un virement attendu n’est toujours pas versé sur votre compte bancaire au bout de 10 jours ouvrables, contactez votre banque en lui fournissant cet ID de suivi. Pour les utilisateurs de Connect, vous pouvez fournir à vos comptes connectés leurs identifiants de traçabilité des virements en les[récupérant à partir de l’API Stripe](https://docs.stripe.com/api/payouts/retrieve.md?api-version=2024-11-20.acacia). Vos comptes connectés peuvent ainsi faire eux-mêmes le suivi de leurs virements manquants ou en retard sans avoir besoin d’une intervention manuelle du support. Le `trace_id` contient deux sous-champs : [value](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id-value) et [status](https://docs.stripe.com/api/payouts/object.md?api-version=2024-11-20.acacia#payout_object-trace_id-status) : - `value` : la chaîne d’ID de suivi que nous récupérons auprès de nos partenaires bancaires lorsqu’un virement est effectué. - `status` : l’état actuel de l’identifiant de suivi lors de sa récupération auprès de nos partenaires bancaires. | État | Description | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pending` | Une fois que vous avez marqué un virement comme payé, Stripe tente de récupérer l’ID de suivi auprès du partenaire bancaire pendant une période pouvant aller jusqu’à 10 jours. Pendant ce délai, l’attribut `status` passe à l’état `pending` | | `supported` | Après que le partenaire bancaire a fourni l’ID de suivi, l’attribut `status` passe à l’état `supported` et Stripe met à jour l’attribut `value`. | | `unsupported` | Certains scénarios empêchent d’obtenir l’ID de suivi, comme un échec de virement ou une combinaison de pays et de devise non prise en charge. Dans ces cas, l’attribut `status` est `unsupported`. | ## Impact Pour obtenir un ID de suivi, [récupérez le virement](https://docs.stripe.com/api/payouts/retrieve.md?api-version=2024-11-20.acacia) concerné. Pour les utilisateurs Connect, fournir l’ID de suivi à vos comptes connectés vous permet de : - Minimiser les demandes de support de vos comptes connectés relatives aux virements manquants ou en retard. - Améliorer la satisfaction des utilisateurs en permettant à vos comptes connectés de gérer eux-mêmes leurs demandes d’information sur les virements manquants ou en retard auprès de leur banque. ## Modifications #### API REST | Parameter | Change | Resources or endpoints | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Ruby Cette modification n’affecte pas le SDK Ruby. #### Python | Parameter | Change | Resources or methods | | ---------- | ------ | ------------------------------------------------------------------ | | `trace_id` | Added | [stripe.Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### PHP | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Java | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Node.js | Parameter | Change | Resources or methods | | ---------- | ------ | ----------------------------------------------------------- | | `trace_id` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### Go | Parameter | Change | Resources or methods | | --------- | ------ | ----------------------------------------------------------- | | `TraceID` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | #### .NET | Parameter | Change | Resources or methods | | --------- | ------ | ----------------------------------------------------------- | | `TraceId` | Added | [Payout](/api/payouts/object?api-version=2024-11-20.acacia) | ## 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 : 2024-11-20.acacia` 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 [v13.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.2.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 [v11.3.0](https://github.com/stripe/stripe-python/releases/tag/v11.3.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 [v16.3.0](https://github.com/stripe/stripe-php/releases/tag/v16.3.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 [v28.1.0](https://github.com/stripe/stripe-java/releases/tag/v28.1.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 [v17.4.0](https://github.com/stripe/stripe-node/releases/tag/v17.4.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 [v81.1.0](https://github.com/stripe/stripe-go/releases/tag/v81.1.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 [v47.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.1.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).