Offre une plus grande souplesse pour la gestion des annulations d’abonnement en fin de périodeVersion bêta publique
Nouveautés
Nous avons introduit de nouvelles valeurs d’énumération cancel_at pour les abonnements configurés avec un comportement flexible (dont le paramètre billing_mode est défini sur flexible). Cette modification simplifie l’annulation d’un abonnement à la fin d’une période de facturation avec des périodes mixtes.
Les nouvelles valeurs d’énumération cancel_at sont les suivantes :
min_period_ end max_period_ end
Utilisez ces valeurs pour annuler l’items.data.current_period_end le plus ancien et le plus récent parmi tous les postes d’abonnement.
Ces nouvelles valeurs d’énumération définissent la date d’annulation en fonction de l’items. de l’abonnement actuel. Contrairement à cancel_at_period_end, ces valeurs sont immédiatement résolues en horodatage et ne sont pas affectées par d’autres modifications de items..
Le paramètre cancel_at_period_end est désormais obsolète. Le comportement de ce paramètre est inchangé, mais dans le contexte des abonnements à périodes mixtes, il est annulé par défaut à la fin de la période la plus ancienne.
Impact
Les endpoints d’API suivants prennent en charge ces nouvelles valeurs :
Si votre intégration utilise actuellement le paramètre obsolète cancel_at_period_end pour annuler les abonnements, utilisez le nouveau paramètre cancel_at avec la valeur d’énumération min_. Le champ cancel_ d’un abonnement n’est pas compatible avec les nouveaux assistants cancel_.