> ## 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.
# Справочник по конфигурации обновлений подписок
На этой странице собраны подробные правила, лежащие в основе мастера настройки Subscription Upgrade: как определяются цены, как работают параметры времени применения и скидок, триггер пригодности и почему товар предложения является заполнителем. Пошаговое руководство см. в статье [Настройка обновлений подписок](/ru/aftersell/subscription-upgrades-setup).
## Состояния проверки API-ключа
На шаге 1 кнопка **Test API key** проверяет ваш токен у провайдера: проходит ли он аутентификацию, есть ли у него все необходимые области доступа (scopes) и принадлежит ли он вашему магазину. Результат отображается в одном из двух состояний:
* **Зеленая галочка, «API key verified».** Токен прошел аутентификацию, все необходимые области доступа присутствуют, и токен принадлежит вашему магазину. Кнопка **Continue** становится доступной.
* **Красный значок отмены.** Проверка не прошла успешно. Сообщение рядом со значком указывает, что из двух произошло: ваш провайдер **отклонил** токен (отозван или не имеет необходимых областей доступа, и в сообщении названа конкретная проблема) либо Aftersell **не смог завершить проверку** («Could not verify the API key. Please try again.»), что означает неудачный вызов, а не плохой токен. Исправьте токен, если он был отклонен; в противном случае просто повторите проверку.
Третьего, промежуточного состояния нет, а результат «не удалось проверить» выглядит точно так же, как отклонение, поэтому ориентируйтесь на сообщение, а не на значок. Кнопка **Continue** остается недоступной, пока проверка не завершится зеленой галочкой. Изменение провайдера или токена сбрасывает предыдущий результат, поэтому после любого изменения проверяйте снова. Эта проверка нужна, чтобы предотвратить сбои обновления подписки, которые иначе обнаружились бы только после списания средств с клиента.
## Триггер пригодности: Variant on subscription
Мастер автоматически настраивает для вас один триггер; задавать его вручную не нужно:
| Триггер | Настройка |
| - | - |
| **Variant on subscription** | Устанавливается на ваш подходящий (целевой) вариант. Срабатывает, только если этот вариант присутствует в заказе **в подписочной позиции**. |
Все включенные триггеры используют логику AND: для показа воронки должно выполняться каждое условие. Вы можете добавить поверх дополнительные необязательные триггеры на шаге **Triggers** редактора воронки (они сгруппированы в сворачиваемом разделе **Additional triggers**, который показывает их количество и открывается автоматически, если необязательные триггеры заданы).
**Не заменяйте его сочетанием триггера Product и триггера Subscription.** Это устаревшее сочетание представляет собой два независимых условия, поэтому заказ, содержащий ваш товар-триггер как *разовую* покупку вместе с *несвязанным* подписочным товаром, удовлетворяет обоим: воронка срабатывает, а затем обновление не выполняется, потому что нет соответствующей подписки для изменения. **Variant on subscription** — это одно условие, которое не может так распасться, и мастер автоматически переводит старые воронки с этого сочетания.
Без триггера по конкретному товару воронка может показываться клиентам, в заказе которых нет подходящего подписочного товара. Это расходует показы впустую и приводит к изменению подписки, которое незаметно завершается неудачей: товар предложения добавляется в заказ, но ни одна подписка в Recharge, Skio или Loop не изменяется.
Если включен параметр **Show this funnel for all customers**, он переопределяет все остальные триггеры, и воронка срабатывает при каждом оформлении заказа. Для воронок обновления подписок это не рекомендуется.
## Какую цену показывает Recurring subtotal
**Recurring subtotal** в предложении сообщает клиенту, сколько будет стоить его следующее продление. С какого товара берется эта цена, зависит от типа обновления:
| Тип обновления | Откуда берется цена |
| - | - |
| Change delivery or billing frequency | Товар-**триггер** |
| Replace with a different subscription product | **Заменяющий** товар |
| Both, change frequency and replace subscription product | **Заменяющий** товар |
| Add another subscribable item to subscription | **Добавляемый** товар |
Это самый частый источник путаницы. Обновление только частоты по замыслу сохраняет тот же товар, поэтому его recurring subtotal всегда может показывать только цену товара-триггера, какую бы частоту вы ни задали. Если вы ожидали увидеть там цену другого товара, скорее всего, вам нужен тип **Both, change frequency and replace subscription product**.
Используемое количество берется из поля **Override subscription quantity**, которое появляется только для типов с заменой. Для обновления только частоты оно всегда равно 1.
## Время применения обновления
По умолчанию обновление вступает в силу со **следующего платежного цикла** клиента, сохраняя существующую дату продления.
Если для вашего магазина включен параметр времени применения, под полями частоты появляется флажок:
> **My fulfillment provider ships the upgraded item on the current order**
Если его отметить, новый платежный интервал начинается немедленно, а не при следующем продлении, а на шаге 4 становится доступным поле **One-time upgrade price**.
Aftersell не изменяет заказ, который клиент только что оформил. Эта настройка сдвигает только платежный интервал. Отмечайте флажок, только если ваш провайдер фулфилмента настроен распознавать товар-заполнитель обновления и отправлять обновленный товар в рамках текущего заказа.
Этот флажок по умолчанию выключен и доступен не во всех магазинах. Он появляется только для типов обновления **Change delivery or billing frequency** и **Both, change frequency and replace subscription product** и только после того, как этот параметр включен для вашего магазина. Если он вам нужен, обратитесь в поддержку через чат в приложении.
## Повторяющаяся скидка
Необязательный стимул, применяемый к **каждому будущему продлению** обновленной подписки (а не только к первому циклу). Недоступен для типа с добавлением товара. Внешний вид поля зависит от того, есть ли у выбранного плана продаж ступенчатые правила ценообразования:
* **Если выбран план продаж с уровнями скидок** (например, план Loop со скидкой \$20 на первое списание и \$10 начиная со второго списания), поле свободного ввода заменяется списком переключателей, по одному на каждый уровень. Каждый вариант показывает размер скидки и диапазон списаний, к которому она применяется (например, «Charge 1» или «Charge 2 onward»). Выберите уровень, который будет применяться к каждому будущему продлению.
* **Если план продаж не выбран или у выбранного плана нет уровней скидок**, отображается стандартное поле свободного ввода. Введите сумму и выберите **Percentage** или **Fixed amount**.
## One-time upgrade price по типу обновления
**One-time upgrade price** — это сумма, которую клиент платит в этом заказе Shopify при принятии предложения.
* Для типов **Change delivery or billing frequency** и **Both** поле по умолчанию заблокировано на `0`, потому что ваш провайдер подписок выполняет списание в конце текущего платежного цикла, а товар-заполнитель отображается в заказе Shopify по цене \$0.00. Поле становится редактируемым, только если на шаге 3 отмечен [флажок времени применения обновления](#upgrade-timing).
* Для типов **Replace with a different subscription product** и **Add another subscribable item to subscription** флажок времени применения не используется, поэтому поле цены всегда доступно для редактирования.
Что в него вводить, зависит от типа обновления:
* **Частота, замена или и то и другое:** *разница* в цене между исходной и обновленной подпиской. Клиент сохраняет свою подписку, а это списание покрывает разницу.
* **Добавление еще одного подписочного товара:** стоимость добавляемого товара в этом заказе. Ничего не заменяется, поэтому вычислять разницу не нужно: это просто сумма, которую клиент платит сейчас за новый товар, который затем будет повторяться вместе с его подпиской. См. статью [Добавление товара в существующую подписку](/ru/aftersell/subscription-upgrades-add-item).
**First-order discount.** Необязательная скидка, применяемая только к этой покупке обновления и задаваемая в процентах (`%`) или фиксированной суммой. Она располагается рядом с **One-time upgrade price** и появляется всякий раз, когда это поле доступно для редактирования, на вкладках **Create new** и **Pick existing**. Для типа с добавлением товара поле все равно отображается, но всегда сохраняется как `0`; предложения с добавлением товара никогда не содержат скидку, поэтому вместо этого задайте нужную цену у товара предложения.
## Почему товар предложения является заполнителем
Товар предложения — это **только визуальный заполнитель**, а не реальный товар, который покупает клиент. Shopify не позволяет показывать подписочный товар как post-purchase апселл после заказа, который уже содержит подписку, поэтому Aftersell фиксирует цену обновления с помощью неподписочного SKU-заполнителя.
* Заданные вами изображение, название и цена отображаются в карточке предложения.
* При принятии отображаемая цена списывается в заказе Shopify, а Recharge, Skio или Loop применяет фактическое обновление к подписке в ее следующем цикле.
* Если вместо создания нового товара вы используете **Pick existing**, товар должен поддерживать разовую покупку; товары, доступные только по подписке, исключаются из списка выбора.