# Suppression d'objets Refund dans les flux de capture partielle et d'annulation de paiement

## Nouveautés

Les flux suivants ne donnent plus lieu à la création d’un objet `Refund` associé au paiement :

- Capture partielle
- Annulation de paiement (manuelle ou automatisée)

## Pourquoi s’agit-il d’une modification majeure ?

Cette modification peut interrompre votre intégration dans les cas suivants :

- Si votre intégration prévoit qu’une capture partielle ou une annulation de paiement crée un objet de remboursement.
- Si votre intégration prévoit qu’une capture partielle crée deux transactions de solde.

Pour en savoir plus sur les effets possibles sur votre intégration, consultez les informations suivantes.

## Impact

Cette modification affecte votre intégration si vous dépendez de l’objet `Refund` ou de champs associés pour les annulations de capture ou de paiement. La suppression de l’objet `Refund` affecte les champs ou objets suivants.

### Objet Refund

- Un objet `Refund` représentant l’annulation ou l’annulation de capture ne sera plus créé.
- Il ne sera pas retourné lorsqu’il est appelé pour obtenir tous les remboursements associés au paiement ou à l’intention de paiement.
- Il ne sera présent dans aucun événement de webhook.
- Il ne sera pas présent sur l’objet `Charge` dans les réponses d’API.
- Il ne sera pas visible dans le Dashboard.

### Objet PaymentIntent

- Une nouvelle valeur `cancellation_reason` appelée `expired` sera introduite. Cette nouvelle valeur représente les paiements annulés en raison de l’expiration de l’autorisation. Elle remplace l’ancienne valeur `automatic`.

### Objet Charge

- `amount_captured` sera égal à 0 au lieu de `nil` dans les flux d’annulation de paiement.
- `amount_refunded` ne sera plus mis à jour par ces actions.
- `refunded` ne sera plus `true` pour les flux d’annulation de paiement.

### Autres transactions associées

- Il n’y aura qu’une seule opération sur solde pour les captures partielles. Il n’y aura plus d’opération sur solde représentant le montant et les frais annulés.
- L’opération sur solde représentant la capture affichera le montant capturé au lieu du montant autorisé pour le paiement correspondant.

### Webhooks

- Nous n’enverrons plus les événements `charge.refunded` et `charge.refund.updated`.
- Nous continuerons à envoyer les événements `charge.expired`, `charge.captured` et `payment_intent.canceled` pour leurs flux respectifs.

### Vérification de paiement Radar

- Le cas échéant, une vérification de paiement Radar sera clôturée en cas d’annulation de paiement avec le motif `canceled` au lieu de `refunded`.

## Modifications

#### API REST

#### Ruby

Cette modification n’affecte pas le SDK Ruby.

#### Python

#### PHP

#### Java

Cette modification n’affecte pas le SDK Java.

#### Node.js

#### Go

#### .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).

## Changements connexes

- [Met à jour l’API Vault and Forward de manière à renvoyer un code d’état 402 pour les expirations de requêtes en amont](https://docs.stripe.com/changelog/basil/2025-03-31/vault-forward-api-returns-402.md)
- [Suppression de la méthode de capture manuelle des cartes Interac](https://docs.stripe.com/changelog/basil/2025-03-31/deprecate-interac-present-manual-capture-method.md)
- [Après la création d’un objet Payment Method, vous ne pouvez plus modifier ses champs Naver Pay](https://docs.stripe.com/changelog/basil/2025-03-31/naver-pay-payment-method.md)
- [Ajout de la prise en charge de Klarna dans la page de facture hébergée](https://docs.stripe.com/changelog/basil/2025-03-31/klarna-send-invoice.md)
- [Ajout de la possibilité de configurer des moyens de paiement enregistrés pour les paiements ponctuels sur la page de facture hébergée](https://docs.stripe.com/changelog/basil/2025-03-31/hosted-payment-method-save.md)
- [Ajout de la prise en charge de l’enregistrement et de la réutilisation des moyens de paiement Naver Pay](https://docs.stripe.com/changelog/basil/2025-03-31/naver-pay-recurring.md)
- [Ajout de la prise en charge du moyen de paiement local Billie](https://docs.stripe.com/changelog/basil/2025-03-31/add-billie.md)
- [Ajout de la prise en charge du moyen de paiement local Satispay](https://docs.stripe.com/changelog/basil/2025-03-31/satispay-lpm.md)
- [Rend le paramètre client facultatif pour WeChat Pay jusqu’à confirmation](https://docs.stripe.com/changelog/basil/2025-03-31/lient-param-optional-wechatpay-before-confirmation.md)
- [Ajout de la prise en charge du moyen de paiement local par prélèvement automatique BECS en Nouvelle-Zélande](https://docs.stripe.com/changelog/basil/2025-03-31/nz-bank-account.md)