Stripe API выпустил версию 2026-09-30.endive с автоматизацией управления подпиской

30 сентября 2026 года Stripe опубликовал API-версию 2026-09-30.endive, первую в серии Endive. Обновление добавило функции автоматизации управления подпиской: паузу и возобновление, отложенную отмену и пробные предложения для отдельных позиций.

Ключевые изменения в Stripe API для автоматизации подписок

В новой версии появился статус paused и конечная точка pause, позволяющая приостанавливать подписки по требованию. Разработчики могут планировать отмену на конец периода через параметр cancel_at_period_end в объекте pending_update. Trial Offers стали общедоступными и работают как повторяющиеся вводные цены для каждой позиции подписки.

Формат billing_cycle_anchor изменился: теперь требуется объект с полем type вместо строковых значений now или unchanged. Это затрагивает endpoints обновления подписок, возобновления и предварительного просмотра счетов. Существующий код, использующий строковые значения, необходимо перевести на объектный формат { type: 'now' } или { type: 'timestamp', timestamp: ... }.

Дополнительные обновления серии Endive включают поддержку паузы подписок в Customer Portal, метод оплаты SeQura для счетов и подписок, а также семантические события для ключевых этапов подписки. Интеграции остаются на предыдущих версиях API до явного обновления.

Как подготовиться к переходу на новую версию Stripe API

Stripe рекомендует тестировать изменения в sandbox-окружении, обновить SDK и обработчики webhook, а также отслеживать неудачные запросы в дашборде. Breaking change по billing_cycle_anchor требует проверки кода, использующего Subscription update, resume и Invoice preview.

Компании в России, использующие Stripe, обычно работают через иностранные юридические лица, поскольку прямое обслуживание российских организаций ограничено. Обновление API не содержит региональных исключений, поэтому интеграции обновляются по общим правилам.

По состоянию на 10 ноября 2026 года массовых проблем с совместимостью не зафиксировано. Разработчики продолжают мониторить дашборд Stripe и документацию для следующих шагов по миграции.

Значение обновления для разработчиков и бизнеса

Новые возможности позволяют точнее управлять жизненным циклом подписок без ручного вмешательства. Пауза и отложенная отмена снижают отток и упрощают работу с клиентами, у которых временно изменились условия оплаты. Пробные предложения помогают тестировать ценообразование на уровне отдельных позиций.

Изменение формата billing_cycle_anchor повышает гибкость, но требует обновления существующих интеграций. Компании, активно использующие Stripe API для управления подпиской, уже начали адаптацию кода под объектный формат.

Stripe продолжает развивать серию Endive, добавляя функции для платежей и событий подписок. Разработчики следят за changelog и тестируют обновления перед переносом в production.