Shopify добавила маршрут /buy для постоянных ссылок на корзину и checkout по стандарту UCP. Анонс от 28 октября относится к версии UCP 2026-08-25. Ссылка может содержать варианты товаров, количество и параметры оформления. Прежний /cart продолжает работать, поэтому миграцию нужно выбирать по поддерживаемому сценарию, а не выполнять заменой строки во всём каталоге ссылок.

Откуда получать адрес

Магазин объявляет capability dev.ucp.shopping.permalink в профиле /.well-known/ucp, а config.endpoint указывает адрес маршрута. Shopify рекомендует брать endpoint из профиля обнаружения. В пути ссылка задаёт пары token:quantity, а дополнительные поля используют параметры UCP, например buyer/email или discounts/codes/0.

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

Какие сценарии пока оставить на /cart

Новый маршрут ещё не поддерживает selling plans, line item properties, cart notes и cart attributes. Если текущая ссылка использует эти возможности, Shopify предлагает пока сохранять /cart. Иначе после формально успешного переноса можно потерять существенные условия заказа, например информацию, связанную с подписочным планом.

Составьте реестр существующих ссылок по назначению. Для каждой отметьте обязательные параметры, размещение и владельца. Такой разбор обычно полезнее массовой миграции: команда видит, какие сценарии готовы к новому формату, а какие зависят от функций, пока отсутствующих в нём. Новые возможности платформы будут направляться в /buy, но это не означает немедленного отключения старых ссылок.

Проверьте неуспешное применение

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

Для контрольного сценария измените условие так, чтобы ожидаемое применение оказалось невозможным, и проверьте фактический переход. Аналогичная дисциплина описана в проверке согласованности checkout URL. У каждого канала свои параметры, но критерий одинаков: покупатель получает именно обещанный результат или понятный путь продолжения.

Не помещайте секреты в ссылку

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

Маршрут относится к техническому оформлению покупки и отличается от включения AI-канала каталога. После миграции сохраните проверенные ссылки и перечень оставшихся ограничений. Приёмка завершена, когда состав корзины, дополнительные параметры и запасной переход проверены на фактическом магазине, а не только синтаксически собраны в коде.