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 les items.data.current_period_end les plus anciens et les plus récents, parmi tous les postes d’abonnement.
Ces nouvelles valeurs d’énumération définissent la date d’annulation établie sur les items. de l’abonnement actuel. Contrairement à cancel_at_period_end, ces valeurs sont résolues en horodatages immédiatement et ne sont pas affectées par d’autres modifications apportées à la valeur 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 mixtes, il est par défaut annulé à la fin de la première période.
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 plutôt 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 nouvelles commandes cancel_.