> ## 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.

# Обновления подписок с Loop

> Пошаговое руководство по подключению Loop и настройке обновлений подписок (Subscription Upgrades) в Aftersell, включая ограничения, специфичные для Loop.

На этой странице описано всё, что касается использования **Loop** с обновлениями подписок (Subscription Upgrades), включая его уникальные ограничения. Полный обзор работы обновлений подписок см. в разделе [Обновления подписок](/ru/aftersell/subscription-upgrades).

<div id="supported-features">
  ## Поддерживаемые функции
</div>

Loop поддерживает все типы обновлений подписок:

* Изменение частоты доставки или списания
* Замена на другой товар
* Оба варианта — изменение частоты и замена товара
* Добавление ещё одного товара с подпиской в подписку (см. [Добавление товара](/ru/aftersell/subscription-upgrades-add-item))
* Только частоты с постоплатой (предоплата не поддерживается — см. [Ограничения](#loop-specific-limitations) ниже)

<div id="loop-specific-limitations">
  ## Ограничения, специфичные для Loop
</div>

* **Частота списания должна совпадать с частотой доставки.** Loop не поддерживает предоплаченные подписки через эту интеграцию. Поле частоты списания отключено и автоматически синхронизируется с частотой доставки. Это самое серьёзное ограничение, о котором нужно знать, если ваш магазин использует предоплаченные планы.
* **Подписки с несколькими позициями** обрабатываются в два этапа: целевая товарная позиция выделяется в новую подписку с нужной частотой, а затем удаляется из исходной. Это включает несколько вызовов API, и во время окна синхронизации в вашей панели Loop могут временно появляться промежуточные позиции.
* **Пользовательская частота не поддерживается для подписок с несколькими позициями.** Если вы задаёте частоту вручную (без выбора плана продаж), обновление работает для клиентов, чья подписка содержит одну товарную позицию. Для клиентов с подпиской на несколько товаров или комплект (две или более активных позиций) обновление завершится ошибкой, если для целевой частоты не существует подходящего плана продаж. Чтобы поддержать таких клиентов, создайте соответствующий план продаж в панели Loop.

<div id="generating-your-loop-api-token">
  ## Создание API-токена Loop
</div>

1. Откройте приложение Loop и перейдите в **Settings** в левом нижнем углу.
2. В разделе **Admin** нажмите **API Tokens**.
3. Задайте разрешения, необходимые Aftersell: **Read and Write** для Subscription contracts и **Read** для Orders и Selling plans. Доступ на запись требуется только для подписок.
4. Нажмите **Generate New Token**.
5. Укажите название, выберите нужные области доступа и нажмите **Generate Token**.
6. Нажмите **Show Token**, чтобы просмотреть и скопировать ключ. Обращайтесь с ним как с паролем и храните в надёжном месте.

Подробнее см. в [документации по API Loop](https://loop.app/docs).

<div id="connecting-loop-in-the-setup-wizard">
  ## Подключение Loop в мастере настройки
</div>

Когда вы дойдёте до шага **Step 1: Connect provider** в мастере обновления подписки:

1. Выберите **Loop** в раскрывающемся списке **Subscription provider**.
2. Вставьте ваш API-токен в поле **API token**.
3. Нажмите **Test API key**. Aftersell проверит токен: корректность аутентификации, наличие всех необходимых областей доступа и принадлежность токена вашему магазину.
4. После успешной проверки (зелёная галочка) нажмите **Continue**, чтобы перейти к шагу 2.

Результат проверки отображается в одном из двух состояний:

* **Зелёная галочка — «API key verified».** Токен прошёл аутентификацию, все необходимые области доступа присутствуют, и токен принадлежит вашему магазину. Кнопка **Continue** теперь доступна.
* **Красный значок отмены.** Проверка не прошла успешно. Прочитайте сообщение рядом со значком: либо токен был отклонён, либо в нём отсутствуют необходимые области доступа. В сообщении указаны конкретные отсутствующие области. Исправьте токен в Loop и повторите проверку. Либо Aftersell не смог завершить проверку («Could not verify the API key. Please try again.») — это сбой вызова, а не неверный токен; в этом случае просто повторите проверку.

Результат «не удалось проверить» выглядит точно так же, как отклонение, поэтому ориентируйтесь на сообщение, а не на значок. Кнопка **Continue** остаётся неактивной, пока проверка не завершится успешно, а изменение провайдера или токена сбрасывает предыдущий результат.

<div id="before-you-configure-the-upgrade-step-3">
  ## Перед настройкой обновления (шаг 3)
</div>

При настройке изменения частоты вы можете либо выбрать существующий план продаж, либо задать частоту вручную:

* **Использовать существующий план продаж.** Выберите его в раскрывающемся списке планов продаж. План должен уже существовать и быть активным в вашей панели Loop.
* **Задать частоту вручную.** Введите частоту доставки самостоятельно. Loop принимает любую периодичность без необходимости в подходящем плане продаж. При использовании ручной частоты вы также можете применить повторяющуюся скидку.

<Note>
  Если вы задаёте частоту вручную, а подписка клиента содержит две или более активных товарных позиций (контракт на несколько товаров или комплект), обновление завершится ошибкой, если для целевой частоты не существует подходящего плана продаж. Подробности см. в разделе [Ограничения](#loop-specific-limitations).
</Note>

<div id="selecting-a-recurring-discount-tier">
  ### Выбор уровня повторяющейся скидки
</div>

Некоторые планы продаж Loop применяют разные скидки на разных этапах подписки — например, скидка \$20 на первое списание и \$10 начиная со второго списания. Когда вы выбираете такой план, поле **Recurring discount** заменяется списком переключателей, показывающих каждый уровень скидки плана с его диапазоном списаний (например, «Charge 1» или «Charge 2 onward»).

Выберите уровень, который должен применяться к каждому будущему продлению обновлённой подписки. Выбранный уровень сохраняется вместе с предложением и применяется, когда клиент принимает обновление.

Если у выбранного плана нет уровней скидок или вы задаёте частоту вручную, вместо этого отображается стандартное поле свободного ввода скидки.

<div id="verifying-an-upgrade-in-loop">
  ## Проверка обновления в Loop
</div>

После размещения тестового заказа и принятия предложения об обновлении:

Перейдите в раздел **Subscriptions** в панели Loop и найдите подписку клиента. Вызовы обновления в Loop синхронны, поэтому на стороне Aftersell нет задержки обработки — изменение применяется в Loop в момент возврата вызова. Собственный *список* подписок Loop может обновляться чуть дольше, поэтому если изменения ещё нет, подождите несколько минут и обновите страницу, прежде чем считать это сбоем.

Если изменения нет, значит оно не применилось — см. ниже.

<div id="troubleshooting-loop-specific-issues">
  ## Устранение проблем, специфичных для Loop
</div>

**Я не могу изменить частоту списания**

Это ожидаемое поведение. Loop не поддерживает предоплаченные подписки через эту интеграцию. Поле частоты списания отключено и автоматически синхронизируется с частотой доставки.

**Обновление было принято, но подписка не изменилась**

Если подписка осталась без изменений, наиболее частые причины:

* Вы задали частоту вручную, а подписка клиента содержит две или более активных товарных позиций. В этом случае Loop требует наличия подходящего плана продаж для целевой частоты. Создайте план продаж в Loop или переключитесь на вариант **Use an existing selling plan** в настройках предложения.
* Вы использовали **Use an existing selling plan**, а выбранный план продаж больше не существует в вашей панели Loop. Создайте план продаж в Loop и повторите попытку.
* Срок действия вашего API-токена истёк или у него нет необходимых разрешений: **write** для Subscription contracts, **read** для Orders и Selling plans. Перейдите к шагу **Step 1: Connect provider**, повторно проверьте ключ и посмотрите в сообщении об ошибке, каких именно областей доступа не хватает.
* Подходящий товар в воронке не совпадает с тем, на что клиент фактически подписан.

Aftersell автоматически повторяет неудачные вызовы провайдера в фоновом процессе. Если все повторы завершились неудачей, обратитесь в поддержку, указав URL вашего магазина, идентификатор заказа Shopify, адрес электронной почты клиента, приблизительное время принятия обновления и используемого провайдера.

**Раскрывающийся список планов продаж пуст**

Вариант «Use an existing selling plan» получает планы напрямую из Loop. Если список пуст:

* Убедитесь, что планы продаж настроены в вашей панели Loop.
* Убедитесь, что у вашего API-токена есть доступ **Read** к Selling plans.
* Вернитесь к шагу **Step 1: Connect provider**, повторно проверьте API-ключ и продолжите.

**В моей панели Loop появляются временные промежуточные позиции**

Это ожидаемо для подписок с несколькими позициями. Loop обрабатывает их в два этапа (разделение, затем удаление), поэтому между этими этапами может появиться временная позиция. Она исчезает, как только завершается второй этап.

***

← Назад к [Обзору обновлений подписок](/ru/aftersell/subscription-upgrades) · [Настройка и конфигурация](/ru/aftersell/subscription-upgrades-setup) · [Что такое интеграции?](/ru/aftersell/subscription-upgrades-integrations)