Adds retention policy cancellation reason to Subscriptions
Adds the canceled_by_retention_policy enum value to the cancellation_details.reason attribute on Subscription objects. For subscriptions canceled by Stripe’s test data retention policy, the cancellation_details.reason property is now canceled_by_retention_policy instead of cancellation_requested.
docs.stripe.comquote checked- behaviour change
- Your codeby hand
Nemotron fixes
In its own wordsmatches the page ✓
| [Adds retention policy cancellation reason to Subscriptions](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-new-cancellation-reason-subscription-test-retention-policy.md) | Billing | Breaking | api |
Also readmatches the page ✓
For subscriptions canceled by Stripe’s test data retention policy, the `cancellation_details.reason` property is now `canceled_by_retention_policy` instead of `cancellation_requested`.
- If your integration expects subscriptions canceled by the retention policy to have a cancellation_details.reason of cancellation_requested, then you need to update your code to expect a value of canceled_by_retention_policy instead. Also, if your integration explicitly handles all possible values of cancellation_details.reason, you need to update your code to handle the new canceled_by_retention_policy value.
What Teire looks for in your code
nothing to search for: checked by hand
Does it reach your code?