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 le paramètre current_period_end d’un poste d’abonnement et qui définissent l’une de ces nouvelles valeurs, le paramètre current_period_end est mis à jour est considéré comme la date d’annulation correspondante. Contrairement à cancel_at_period_end, ces valeurs sont résolues en horodatage immédiatement et les modifications ultérieures 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
• Mise à jour de l’abonnement
• Créer une facture préliminaire

Si votre intégration de facturation en mode flexible utilise actuellement la valeurcancel_at_period_end pour annuler les abonnements, mettez à jour votre intégration pour :

• Utilisez les nouvelles valeurs de l’enum min_period_end ou max_period_end pour spécifier l’intervalle qui déclenche l’annulation.
• Remplissez cancel_at avec un horodatage 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 éléments 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 le timestamp cancel_at existant de l’abonnement.

Modifications

Mise à niveau