Заказ из Яндекса

Яндекс приводит покупателя. Заказ сразу оказывается в Shop-Script

Покупатель нажимает «Купить» в Яндекс Товарах или Алисе, проверяет корзину и оформляет заказ в привычном интерфейсе Яндекса. Плагин в этот момент заново сверяет цену и остаток, принимает подтверждение оплаты и создаёт обычный заказ Shop-Script.

Менеджер продолжает работать там, где уже ведёт продажи: видит покупателя, товары, доставку, оплату и источник заказа. Отдельно переносить заказ из кабинета Яндекса не нужно.

Не просто принять запрос, а безопасно провести заказ

Проверить корзину перед оплатой. Цена, доступность и количество читаются из Shop-Script при каждом запросе Яндекса.

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

Не создать дубль. Повторный checkout/placed с тем же session_id возвращает уже созданный заказ.

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

Сохранить стандартный workflow. Новый, оплаченный, завершённый, отменённый и возвращённый заказ остаётся обычным заказом Shop-Script.

Разобраться без утечки данных. Диагностический журнал хранит только метод, путь, код ответа и время выполнения — без токенов, покупателя, тела запроса и состава заказа.

Полный контур YCP

Плагин реализует все 10 методов актуального Yandex Checkout Protocol:

проверка корзины;

создание, подтверждение и отмена checkout-сессии;

курьерские варианты доставки и точки выдачи;

получение заказа;

отмена и подтверждение доставки заказа.

Ответы отдаются в JSON без кэширования. Доступ закрыт bearer-токеном, размер тела запроса ограничен, входные ID и обязательные поля проверяются до обращения к каталогу и workflow.

Как подключить

Создайте отдельный YML-фид для Яндекс Товаров и определите стабильный offer id .

Установите плагин и оставьте приём запросов выключенным.

Укажите HTTPS-витрину, URL фида, правило offer id , товары и данные склада.

Скопируйте готовый URL API и автоматически созданный токен в настройки YCP.

Проверьте встроенную диагностику и тестовую корзину.

Включите приём запросов. После проверки фида и магазина Яндекс сможет показать кнопку «Купить» на своих поверхностях.

Товарные ID без ручной магии

При проверке корзины Яндекс передаёт идентификатор предложения из YML-фида. Плагин поддерживает три прозрачных правила:

артикул Shop-Script — рекомендуется;

внутренний ID артикула;

ID товара для простого предложения с основным артикулом.

После сопоставления плагин возвращает YCP стабильный внутренний ID артикула. Следующие этапы checkout уже не зависят от текста артикула или структуры URL.

Контроль остатков без опасных предположений

Конечный остаток передаётся как есть. Пустой остаток в Shop-Script означает неограниченное количество, а YCP требует целое число. Для этого случая задаётся отдельный безопасный лимит на один заказ. Скрытый товар, выключенный артикул, нулевая цена или нулевой остаток дают доступное количество 0.

Почему это надёжнее простой API-прокладки

Простая передача запросов Заказ из Яндекса

Доверяет цене, пришедшей в checkout Повторно читает цену из Shop-Script перед созданием

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

В фид может случайно попасть весь каталог Набор товаров и точный белый список ограничивают продажу

Ошибка видна только в серверном логе Настройки сразу показывают готовность токена, витрины, склада, товаров и ID

Отладка рискует записать персональные данные Журнал содержит только безопасные технические метаданные

Доставка и оплата

Для первой версии доступен один профиль склада. Можно включить самовывоз с будничным расписанием и курьерскую доставку магазина с фиксированной стоимостью, сроком в рабочих днях и часовым поясом. Метод точек выдачи реализован по протоколу и возвращает пустой список, пока у магазина нет собственного справочника ПВЗ.

Заказ можно связать с установленными способами доставки и оплаты Shop-Script. При payment_method=online заказ отмечается оплаченным только после подтверждения YCP. При оплате при получении заказ остаётся новым.

Честно о границах плагина

Плагин реализует серверную часть YCP и создаёт заказы. Он не создаёт YML-фид, не регистрирует магазин в Яндексе, не подключает эквайринг и онлайн-чеки и не управляет решением модерации. Кнопка «Купить» появляется на поверхностях Яндекса после отдельной настройки Яндекс Товаров и YCP; на витрину Shop-Script плагин собственную кнопку не добавляет.

Системные требования: Webasyst Framework 2.9+, Shop-Script 9.0+, PHP 7.4+, JSON и mbstring. Поддерживается Shop-Script ПРЕМИУМ.