> ## Documentation Index > Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt > Use this file to discover all available pages before exploring further. # Обновления подписок со Stay AI > Пошаговое руководство по подключению Stay AI и настройке обновлений подписок (Subscription Upgrades) в Aftersell, включая ограничения Stay AI, связанные с предоплаченными планами, отменами и валютой. На этой странице описано всё, что касается использования **Stay AI** с обновлениями подписок (Subscription Upgrades), включая его уникальные ограничения. Полный обзор работы обновлений подписок см. в разделе [Обновления подписок](/ru/aftersell/subscription-upgrades).
## Поддерживаемые функции
Stay AI поддерживает все типы обновлений подписок: * Изменение частоты доставки или списания (применяется ко всей подписке) * Замена на другой товар * Оба варианта — изменение частоты и замена товара * Добавление ещё одного товара с подпиской в подписку (см. [Добавление товара](/ru/aftersell/subscription-upgrades-add-item)). Если клиент уже подписан на этот товар, Stay увеличивает его количество вместо добавления новой позиции (для этого действует условие совпадения цены — см. ограничения ниже). * Частоты с постоплатой (оплата за каждую доставку), включая перевод подписки с постоплатой на план с оплатой вперёд (с условиями, описанными ниже) Замена товара поддерживается, **кроме замены на товар, который продаётся только по планам с оплатой вперёд**, — см. ограничение для предоплаты ниже.
### Перевод подписки на план с оплатой вперёд
Перевод подписки с постоплатой на план с оплатой вперёд (предоплаченный) поддерживается при двух условиях: * **План с оплатой вперёд должен уже существовать в Stay AI и быть назначен товару.** Aftersell не может создать такой план; предложение позволяет выбрать только из планов, уже настроенных в Stay AI. * **При переводе создаётся новая подписка, а старая отменяется.** Stay вносит это изменение, создавая новую подписку на плане с оплатой вперёд и отменяя исходную, поэтому подписка получает **новый идентификатор**. Складским системам, 3PL и инструментам отчётности, которые отслеживают подписки по идентификатору, потребуется повторная синхронизация. См. [Исполнение заказов и сопоставление с 3PL](/ru/aftersell/subscription-upgrades-fulfillment).
## Ограничения, специфичные для Stay AI
* **Предоплаченные подписки (с оплатой вперёд) нельзя изменить.** Stay не допускает никаких изменений подписки, за которую клиент заплатил вперёд, независимо от типа обновления. Если клиент на предоплаченном плане принимает предложение об обновлении, обновление отменяется, а средства возвращаются, поэтому подписка остаётся без изменений. По той же причине нельзя заменить подписку на товар, который продаётся только по планам с оплатой вперёд. * **Уведомления об отменах получает только одно приложение на аккаунт.** Stay отправляет обновления об отменах только **одному приложению на аккаунт**. Если другое приложение или интеграция зарегистрировались на вебхук отмен Stay раньше Aftersell, Aftersell не сможет получать эти обновления, и [график отменённых подписок](/ru/aftersell/analytics_metrics_reference#subscriptions-cancelled-chart) не будет отражать отмены в Stay. Чтобы отслеживание отмен вообще работало, подключаемый API-ключ должен включать разрешение **Webhooks** (см. ниже). * **Изменение частоты применяется ко всей подписке.** У Stay один график на подписку, поэтому изменение частоты доставки затрагивает все товары в ней. Если подписка содержит два или более товара, необходимо включить в предложении **Keep on existing subscription**; в противном случае обновление частоты будет отклонено, а покупателю вернут средства. Это требуется только для изменения частоты — замена товара и дополнения не затрагиваются и работают без этой настройки. * **Для добавления товара, на который клиент уже подписан, нужна совпадающая цена.** Если дополнение — это товар, который у клиента уже есть, Stay увеличивает его количество вместо добавления позиции, но только если цена предложения совпадает с той, которую клиент уже платит за него. Если цены различаются (например, дополнение предлагается со скидкой 20%, а план клиента даёт 10%), обновление отклоняется, и подписка остаётся без изменений. Задайте для дополнения ту же скидку, что и в плане клиента, или предложите другой товар (на другой товар это не влияет). * **Валюта должна соответствовать ценам вашего магазина.** Если подписка клиента оплачивается в валюте, в которой ваш магазин не устанавливает цены, обновление отклоняется. * **Дублирующиеся подписки из одного заказа невозможно различить.** Если один заказ создал две подписки Stay, каждая из которых содержит товар предложения, Aftersell не может определить, какую из них имел в виду клиент, и обновление отклоняется, а не применяется к неверному контракту. * **Лимиты запросов ограничивают пропускную способность.** Stay допускает 60 запросов в минуту на аккаунт. Одно обновление занимает от четырёх до шести запросов, поэтому в пиковые моменты магазин может обработать примерно 10–15 обновлений в минуту.
## Создание API-ключа Stay AI
1. В панели Stay AI перейдите в **Account → API tokens → Add API key**. 2. При создании ключа выберите **All permissions**. Aftersell нужен доступ к **Subscriptions**, **Orders**, **Selling Plan Groups** и **Webhooks**. Именно разрешение Webhooks позволяет Aftersell получать уведомления об отменах. 3. Скопируйте ключ и храните его в надёжном месте. Обращайтесь с ним как с паролем. Подробнее см. в [документации Stay AI по аутентификации API](https://docs.stay.ai/reference/authentication).
## Подключение Stay AI в мастере настройки
Когда вы дойдёте до шага **Step 1: Connect provider** в мастере обновления подписки: 1. Выберите **Stay AI** в раскрывающемся списке **Subscription provider**. 2. Вставьте ваш API-ключ в поле **API key**. 3. Нажмите **Test API key**. Aftersell проверит ключ: корректность аутентификации и принадлежность ключа вашему магазину. 4. После успешной проверки (зелёная галочка) нажмите **Continue**, чтобы перейти к шагу 2. Результат проверки отображается в одном из двух состояний: * **Зелёная галочка — «API key verified».** Ключ прошёл аутентификацию и принадлежит вашему магазину. Кнопка **Continue** теперь доступна. Если у ключа нет разрешения **Webhooks**, проверка всё равно проходит, но выводится предупреждение о том, что отмены подписок не будут регистрироваться, — если вам нужно отслеживание отмен, создайте ключ в Stay AI заново с **All permissions**. * **Красный значок отмены.** Проверка не прошла успешно. Прочитайте сообщение рядом со значком: либо ключ был отклонён, либо Aftersell не смог завершить проверку («Could not verify the API key. Please try again.») — это сбой вызова, а не неверный ключ; в этом случае просто повторите проверку. Результат «не удалось проверить» выглядит точно так же, как отклонение, поэтому ориентируйтесь на сообщение, а не на значок. Кнопка **Continue** остаётся неактивной, пока проверка не завершится успешно, а изменение провайдера или ключа сбрасывает предыдущий результат.
## Проверка обновления в Stay AI
После размещения тестового заказа и принятия предложения об обновлении: Перейдите в раздел **Subscriptions** в панели Stay AI и найдите подписку клиента. Частота списания, товар или дата следующего списания должны отражать изменение. Само изменение применяется, как только Aftersell обработает принятие предложения, но Stay может медленно принимать совершенно новый заказ: обычно обновление появляется в течение нескольких минут, а в самых медленных случаях — до 24 часов. Если изменения ещё нет, подождите немного, прежде чем считать это сбоем.
## Если обновление не удаётся применить
Обновления Stay AI безопасны по своей конструкции — с покупателя никогда не списываются средства за обновление, которое не произошло: * **Неудачные обновления повторяются автоматически.** Если вызов к Stay AI завершается ошибкой, Aftersell повторяет его в фоновом процессе. * **Если обновление всё равно не удаётся применить, покупателю возвращаются средства.** Subscription Upgrade списывает только небольшую позицию-заполнитель в заказе Shopify (а не товар, который покупатель оставляет себе), поэтому Aftersell возвращает это списание, если обновление не удаётся завершить. * **Всё, что невозможно подтвердить, помечается для ручной проверки**, а не угадывается, поэтому с покупателя никогда не списываются средства за обновление, которое не произошло. Полное описание механизма повторов и сверки (общего для всех провайдеров) см. в разделе [Как работают обновления подписок](/ru/aftersell/subscription-upgrades#how-subscription-upgrades-work).
## Устранение проблем, специфичных для Stay AI
**Обновление было принято, но подписка не изменилась** Наиболее частые причины: * Клиент находится на **предоплаченном плане (с оплатой вперёд)**. Stay не позволяет изменять предоплаченные контракты, поэтому обновление отменяется, а средства возвращаются. Это ожидаемое поведение. * Подписка оплачивается в **валюте, в которой ваш магазин не устанавливает цены**, поэтому обновление было отклонено. * Подписка содержит **два или более товара**, а вы изменили частоту, не включив **Keep on existing subscription**. * Один заказ создал **две подписки Stay**, каждая из которых содержит товар предложения, поэтому Aftersell не смог определить, какую из них обновлять. * Ваш API-ключ принадлежит другому магазину или у него нет необходимого разрешения (**Subscriptions**, **Orders** или **Selling Plan Groups**). Создайте ключ заново или выберите другой в Stay AI, перейдите к шагу **Step 1: Connect provider** и повторите проверку. * Подходящий товар в воронке не совпадает с тем, на что клиент фактически подписан. Aftersell автоматически повторяет неудачные вызовы провайдера в фоновом процессе. Если все повторы завершились неудачей, обратитесь в поддержку, указав URL вашего магазина, идентификатор заказа Shopify, адрес электронной почты клиента, приблизительное время принятия обновления и используемого провайдера. **Отмены в Stay не отображаются в аналитике** Stay отправляет обновления об отменах только одному приложению на аккаунт. Если другое приложение зарегистрировалось на вебхук отмен Stay раньше Aftersell, Aftersell не сможет их получать. Убедитесь, что вебхук отмен Stay не занят другой интеграцией, и проверьте, что подключённый API-ключ включает разрешение **Webhooks**. *** ← Назад к [Обзору обновлений подписок](/ru/aftersell/subscription-upgrades) · [Настройка и конфигурация](/ru/aftersell/subscription-upgrades-setup) · [Что такое интеграции?](/ru/aftersell/subscription-upgrades-integrations)