Ajoute des aides pour résilier les abonnements pour les périodes de facturation avec des intervalles mixtes

Nouveautés

Nous avons introduit les valeurs d’énumération cancel_at suivantes pour simplifier l’annulation d’un abonnement à intervalles mixtes à la fin d’une période de facturation :

• min_period_end : planifie l’annulation de l’abonnement à la items.data.current_period_end la plus ancienne, pour tous les postes d’abonnement.
• max_period_end : planifie l’annulation de l’abonnement au plus tard items.data.current_period_end pour tous les postes d’abonnement.

Dans les requêtes qui modifient à la fois la current_period_end d’un poste d’abonnement et qui définissent l’une de ces nouvelles valeurs, la current_period_end mise à jour est prise comme date d’annulation respective. Contrairement à cancel_at_period_end, ces valeurs se résolvent en horodatage immédiatement et les autres modifications apportées à items.data.current_period_end ne les affectent pas.

Impact

Les endpoints suivants de l’API prennent en charge les nouveaux enums :

• Créer un abonnement
• Mettre à jour un abonnement
• Créer un aperçu de la facture

Si votre intégration du mode de facturation flexible utilise actuellement cancel_at_period_end pour résilier les abonnements, mettez à jour votre intégration pour qu’elle utilise l’une ou l’autre de ces options :

• Utilisez les nouvelles valeurs de l’enum min_period_end ou max_period_end pour spécifier l’intervalle qui déclenche l’annulation.
• Remplir cancel_at avec un timestamp entier explicite.

Le paramètre cancel_at_period_end sur un abonnement n’est pas compatible avec les nouvelles aides cancel_at.

Si vous mettez à jour la valeur current_period_end pour les postes d’un abonnement, vous pouvez ajouter cancel_at : min_period_end ou cancel_at : max_period_end dans la même requête pour réinitialiser l’horodatage cancel_at existant de l’abonnement.

Modifications

Mise à niveau