# Ajoute une nouvelle valeur aux motifs de clôture des examens de paiement.

## Nouveautés

Introduction de `payment_never_settled` et `acknowledged` comme nouvelles valeurs d’énumération de l’objet `Review` [closed_reason](https://docs.stripe.com/api/radar/reviews/object.md?api-version=preview#review_object-closed_reason). La valeur `payment_never_settled` fournit une raison plus détaillée pour spécifier quand la banque émettrice refuse la transaction qui déclenche la fermeture automatique de la vérification. La valeur `acknowledged` fournit la raison pour laquelle un utilisateur a vérifié et clôturé la vérification du paiement.

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

L’ajout de nouvelles valeurs enum est considéré comme un changement cassant, car les intégrations utilisateur existantes peuvent ne pas anticiper ou gérer correctement ces nouvelles valeurs. Cela peut entraîner des comportements inattendus, des erreurs ou des défaillances dans les systèmes qui reposent sur la gestion explicite de cas enum connus.

## Impact

Les révisions de paiements clôturés incluent désormais la nouvelle valeur `payment_never_settled` comme `closed_reason`. Mettez à jour votre intégration pour traiter cette valeur en conséquence.

## Modifications

#### API REST

| Parameters                | Change  | Resources or endpoints                                             |
| ------------------------- | ------- | ------------------------------------------------------------------ |
| `closed_reason`, `reason` | Removed | [Review](/api/radar/reviews/object?api-version=2025-07-30.preview) |

#### Ruby

| Parameters                | Change  | Resources or methods                                               |
| ------------------------- | ------- | ------------------------------------------------------------------ |
| `closed_reason`, `reason` | Removed | [Review](/api/radar/reviews/object?api-version=2025-07-30.preview) |

#### Python

| Parameters                | Change  | Resources or methods                                               |
| ------------------------- | ------- | ------------------------------------------------------------------ |
| `closed_reason`, `reason` | Removed | [Review](/api/radar/reviews/object?api-version=2025-07-30.preview) |

#### PHP

| Parameters                | Change  | Resources or methods                                               |
| ------------------------- | ------- | ------------------------------------------------------------------ |
| `closed_reason`, `reason` | Removed | [Review](/api/radar/reviews/object?api-version=2025-07-30.preview) |

#### Java

| Parameters               | Change  | Resources or methods                                               |
| ------------------------ | ------- | ------------------------------------------------------------------ |
| `closedReason`, `reason` | Removed | [Review](/api/radar/reviews/object?api-version=2025-07-30.preview) |

#### Node.js

| Parameters                | Change  | Resources or methods                                               |
| ------------------------- | ------- | ------------------------------------------------------------------ |
| `closed_reason`, `reason` | Removed | [Review](/api/radar/reviews/object?api-version=2025-07-30.preview) |

#### Go

| Parameters               | Change  | Resources or methods                                               |
| ------------------------ | ------- | ------------------------------------------------------------------ |
| `ClosedReason`, `Reason` | Removed | [Review](/api/radar/reviews/object?api-version=2025-07-30.preview) |

#### .NET

| Parameters               | Change  | Resources or methods                                               |
| ------------------------ | ------- | ------------------------------------------------------------------ |
| `ClosedReason`, `Reason` | Removed | [Review](/api/radar/reviews/object?api-version=2025-07-30.preview) |

## 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-07-30.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 [v15.5.0-beta.1](https://github.com/stripe/stripe-ruby/releases/tag/v15.5.0-beta.1)
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.5.0b1](https://github.com/stripe/stripe-python/releases/tag/v12.5.0b1)
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.6.0-beta.1](https://github.com/stripe/stripe-php/releases/tag/v17.6.0-beta.1)
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.5.0-beta.1](https://github.com/stripe/stripe-java/releases/tag/v29.5.0-beta.1)
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.5.0-beta.1](https://github.com/stripe/stripe-node/releases/tag/v18.5.0-beta.1)
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.5.0-beta.1](https://github.com/stripe/stripe-go/releases/tag/v82.5.0-beta.1)
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.5.0-beta.1](https://github.com/stripe/stripe-dotnet/releases/tag/v48.5.0-beta.1)
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

- [Ajout de Smart Disputes à l’API Disputes](https://docs.stripe.com/changelog/basil/2025-07-30/adds-smart-disputes.md)