Подключение оплаты через Яндекс Пэй

Яндекс Пэй — платёжный сервис Яндекса: покупатели платят картой, через СБП или частями через Яндекс Сплит; набор способов и начисление баллов Яндекс Плюса — по условиям Яндекса. Подключение: «Настройки магазина» → вкладка «Платежи» → «Добавить» → «Оплата через Яндекс Пэй». Ниже — как зарегистрироваться в Яндекс Пэй, получить Merchant ID и API-ключ, заполнить форму и настроить уведомления об оплате.

Онлайн-кассу по 54-ФЗ применяет продавец, кроме случаев, когда закон от неё освобождает: например, самозанятые выдают чек через приложение «Мой налог». При оплате через Яндекс Пэй чек выдаёт онлайн-касса, подключённая к Яндекс Пэй; касса сторонняя и оплачивается отдельно от услуг Яндекс Пэй. Если отдельную кассу подключать не хотите, посмотрите ЮKassa: она может сама формировать чеки (условия и комиссию сверьте в личном кабинете ЮKassa).

Добавление платёжной системы

Нажмите «Добавить» в блоке «Способы оплаты» на вкладке «Платежи» — откроется окно выбора способа оплаты. Если Merchant ID и API-ключа ещё нет, сначала получите их — порядок описан ниже в разделе «Получение идентификатора продавца (Merchant ID) и API-ключа».

До подключения в списке всего два способа — «Наличными при получении» и «Оплата картой при получении»

Выбор добавляемого способа оплаты

Выберите в окне пункт «Оплата через Яндекс Пэй» — откроется форма с полями «Название способа оплаты», «Merchant ID» и «API-ключ».

Выбор способа оплаты: подсвечена плитка «Оплата через Яндекс Пэй»

Получение идентификатора продавца (Merchant ID) и API-ключа

Переход в личный кабинет Яндекс Пэй

Нажмите ссылку под полями формы «Получите Merchant ID и API-ключ в кабинете Яндекс Пэй», если этих данных у вас ещё нет.
В кабинете Яндекс Пэй зарегистрируйтесь или войдите, создайте магазин и выпустите ключи. Merchant ID — идентификатор вашего магазина в Яндекс Пэй, API-ключ — секретный код, которым магазин подтверждает свои запросы к Яндекс Пэй.

Все три обязательных поля пусты, подсвечена ссылка на кабинет под полем «API-ключ», кнопка «Добавить» бледная

Подготовка документов

Подключиться к Яндекс Пэй может юрлицо, ИП или самозанятый. Требования ниже описаны по сайту Яндекс Пэй на октябрь 2026 — перед подачей заявки сверьте их в личном кабинете Яндекс Пэй.

⚠️ Важно для самозанятых:

  1. Уточните возможность подключения в службе поддержки Яндекс Пэй до начала регистрации.
  2. По данным сайта Яндекс Пэй на октябрь 2026 года, самозанятым доступен приём оплаты через Систему быстрых платежей (СБП) по QR-коду — условия уточните в поддержке сервиса.

Соберите документы и данные заранее, без них заявку не отправить:

  1. ИНН организации / ИП.
  2. БИК и реквизиты расчётного счёта для выплат. Счёт должен принадлежать тому же юрлицу/ИП; новый счёт открывать не нужно — подойдёт действующий.
  3. Название магазина и вид деятельности: от вида деятельности зависит MCC-код (код категории продавца).
  4. Контактное лицо: ФИО, телефон и почта. С контактным лицом свяжется поддержка — человек должен быть на связи.
  5. Для ИП — полный адрес регистрации с индексом.
  6. На сайте: каталог, контакты, публичная оферта, политика возврата, обязательные сведения о продавце. Вместо сайта допускается страница на разрешённой в РФ платформе (соцсеть, мессенджер, Авито).
  7. Публичная оферта или шаблон договора с явным упоминанием оплаты и возвратов через Яндекс Пэй — документ нужно дослать в течение 30 дней после подачи заявки.

Проверьте, что вид деятельности не попадает в запрещённые категории: криптовалюты, азартные игры, табак, алкоголь, финансовые пирамиды и подобное — иначе заявку отклонят.

Комиссия — по тарифу провайдера: ставки для СБП, оплаты по QR-коду и Сплита сверьте в личном кабинете Яндекс Пэй или при согласовании договора.

Регистрация продавца и получение ключей

  1. Войти в консоль console.pay.yandex.ru и авторизоваться через Яндекс ID.
    После входа анкета регистрации открывается автоматически.
  2. Подтвердить контактные данные (телефон + почта из Яндекс ID).
  3. Добавить организацию.
    Укажите ИНН или название организации и выберите её из выпадающего списка.
  4. Заполнить заявку на подключение
    • формат приёма платежей: онлайн или офлайн;
    • онлайн-магазину достаточно названия и сайта;
    • указать реквизиты: БИК, номер счёта и контактное лицо.

Отправить заявку и пройти модерацию.

  1. Поддержка звонит для подтверждения заявки — будьте на связи.
    Сроки на октябрь 2026: рассмотрение — до 3 рабочих дней, полный цикл — около 5 рабочих дней. Точные сроки уточняйте в консоли.
    Статус заявки — на главной странице, в разделе «Сервисы» и в письме на почту.
  2. Дослать оферту
    Отправьте её в срок ≤ 30 дней с момента подачи заявки.
  3. Получить Merchant ID (после одобрения):
    Перейдите в раздел «Сервисы» → «Яндекс Пэй и Сплит» → скопируйте Merchant ID.
  4. Выпустить рабочий API-ключ:
    Перейдите в раздел Настройки → выберите магазин → нажмите «Выпустить Merchant API-ключ».
    • ⚠️ Ключ показывается один раз — сразу скопируйте его в защищённое хранилище, поле Secret (секретный ключ). Посмотреть ключ повторно нельзя; при утере — выпустите новый.
    • Ограничение на октябрь 2026 — максимум 3 активных ключа на магазин.

Для тестового и рабочего режимов:

Начните с тестового режима Яндекс Пэй, если подключаетесь впервые:

  • В личном кабинете Яндекс Пэй включите переключатель «Показать настройки тестовой среды» или «Тестовые данные».
  • В тестовом режиме Merchant ID и API-ключ могут совпадать — это нормально.
  • В форме магазина для тестовых ключей включите переключатель «Тестовый режим Яндекс Пэй».
  • После проверки выключите тестовый режим в кабинете и в форме, при необходимости выпустите отдельный API-ключ для рабочей среды и замените ключ в форме магазина.

Когда оба значения получены, вернитесь к форме способа оплаты в панели магазина — как её заполнить, описано в разделе «Заполнение параметров» ниже.

Заполнение параметров

Заполните три обязательных поля и, по желанию, два переключателя:

  1. Название способа оплаты (обязательное поле).
    Это название покупатели увидят при выборе способа оплаты в корзине и при оформлении заказа.
    Подойдёт понятное покупателю название, например «Банковская карта (Яндекс Пэй)» или просто «Оплата картой».
  2. Merchant ID (обязательное поле).
    Скопируйте Merchant ID из личного кабинета Яндекс Пэй и вставьте в это поле.
  3. API-ключ (обязательное поле).
    Скопируйте API-ключ из личного кабинета Яндекс Пэй и вставьте в это поле.
    ⚠️ Важно: храните API-ключ в безопасности и не передавайте его третьим лицам.
  4. «Тестовый режим Яндекс Пэй» (необязательно).
    Включите, если вставили тестовые Merchant ID и API-ключ: платежи пойдут через тестовую среду (Sandbox) Яндекс Пэй. Перед приёмом настоящих оплат выключите переключатель и вставьте рабочие ключи.
  5. «Показывать баллы Плюса в каталоге и карточке товара» (необязательно).
    Включите, чтобы в каталоге и на странице товара появились информеры с баллами Яндекс Плюса. Корзину, оформление заказа и кнопку оплаты переключатель не меняет.

Название «Оплата картой», «Merchant ID» заполнен длинным идентификатором, API-ключ скрыт точками, флажок баллов Плюса отмечен

Завершение настройки

Нажмите «Добавить» внизу формы, когда обязательные поля заполнены, — Яндекс Пэй появится в списке способов оплаты магазина.

«Назад» — возвращает к выбору способа оплаты; введённые данные не сохранятся.

«Добавить» — сохраняет способ оплаты и подключает Яндекс Пэй к магазину.

Форма готова к отправке: подсветка легла на синюю кнопку внизу справа, рядом кнопка «Назад»

Что должно получиться

В списке способов оплаты появится строка с введённым названием и значком Яндекса. Остальные способы оплаты магазина описаны в статье Способы оплаты.

Итог подключения — третья строка «Оплата картой» с красным значком Яндекса в списке способов

Настройте HTTP-уведомление (вебхук) в личном кабинете Яндекс Пэй

Сразу после сохранения способа оплаты укажите в личном кабинете Яндекс Пэй адрес для HTTP-уведомлений. HTTP-уведомление (вебхук) — сообщение, которое Яндекс Пэй сам отправляет на сервер магазина, когда меняется статус оплаты; по нему магазин узнаёт об успешной или неуспешной оплате заказа.

В поле Callback URL (адрес для уведомлений) укажите полный адрес: домен вашего магазина и путь /api/v2/yandexpay. Яндекс Пэй сам допишет к нему /v1/webhook, поэтому вводить этот хвост не нужно.

Например, если домен магазина:

https://myshop.ru

то в поле Callback URL нужно указать:

https://myshop.ru/api/v2/yandexpay

Замените https://myshop.ru на домен вашего магазина, если у вас другой домен. Путь /api/v2/yandexpay должен остаться без изменений.

Если есть выбор событий для уведомлений, включите событие изменения статуса заказа: ORDER_STATUS_UPDATED.

⚠️ Важно: без HTTP-уведомления магазин запрашивает статус оплаты сам, и только когда покупатель возвращается на страницу заказа после оплаты. Если покупатель закроет страницу Яндекс Пэй или не вернётся по адресу возврата, магазин может не получить статус вовремя, и заказ останется неоплаченным в системе.

Короткие ответы

Нужна ли онлайн-касса для оплаты через Яндекс Пэй?

Да, если продавец не освобождён от применения кассы по 54-ФЗ: чек выдаёт сторонняя онлайн-касса, подключённая к Яндекс Пэй и оплачиваемая отдельно. Самозанятые кассу не применяют и выдают чек через приложение «Мой налог».

Может ли самозанятый подключить Яндекс Пэй?

По данным сайта Яндекс Пэй на октябрь 2026 года, самозанятым доступен приём оплаты через СБП по QR-коду. До регистрации уточните условия в поддержке Яндекс Пэй.

Какой адрес указать в Callback URL Яндекс Пэй?

Домен магазина плюс путь /api/v2/yandexpay, например https://myshop.ru/api/v2/yandexpay; окончание /v1/webhook Яндекс Пэй добавит сам. Без этого адреса заказ может остаться неоплаченным в системе, если покупатель не вернётся на страницу заказа.

Сколько ждать одобрения заявки в Яндекс Пэй?

На октябрь 2026 рассмотрение занимает до 3 рабочих дней, полный цикл подключения — около 5 рабочих дней. Точные сроки показывает консоль Яндекс Пэй.

Влияет ли переключатель баллов Яндекс Плюса на оплату?

Нет. Переключатель «Показывать баллы Плюса в каталоге и карточке товара» только добавляет информеры с баллами в каталог и на страницу товара; корзину, оформление и кнопку оплаты он не меняет.