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

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

Нажмите на кнопку «Добавить».

2. Выбор добавляемой оплаты

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

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

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

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

Подключиться может юрлицо, ИП или самозанятый.

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

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

Собрать заранее (без этого заявку не отправить):

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

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

Ориентиры по комиссиям (маркетинговые, не из договора; согласуются индивидуально): СБП — от 0,4%, QR — от 0,4%, Сплит — ~6%. Комиссия — только с успешно оплаченных заказов. Точные ставки (уточнить при согласовании договора).

5. Регистрация мерчанта и получение ключей

1. Войти в консоль console.pay.yandex.ru, авторизация через Яндекс ID.
   После входа анкета регистрации открывается автоматически.
2. Подтвердить контактные данные (телефон + почта из Яндекс ID).
3. Добавить организацию.
   Потребуется указать ИНН или название вашей организации, затем выбрать её из выпадающего списка.
4. Заполнить заявку на подключение
   • формат приёма (Онлайн/Офлайн);
   • онлайн-магазину достаточно названия и сайта;
   • указать реквизиты (БИК + счёт) и контактное лицо.
5. Отправить заявку и пройти модерацию.
   Поддержка звонит для подтверждения.
   Сроки: рассмотрение — до 3 рабочих дней, полный цикл — ~5 рабочих дней (конкретные цифры — уточнить в консоли).
   Статус — на главной, в «Сервисы» и в почте.
6. Дослать оферту
   ≤30 дней с подачи.
7. Получить Merchant ID (после одобрения):
   Для получения перейти в раздел «Сервисы» → «Яндекс Пэй и Сплит» → скопировать Merchant ID.
8. Выпустить production Api-Key:
   Для получения перейти в раздел Настройки → выбрать магазин → «Выпустить Merchant API-ключ».
   • ⚠️ Ключ показывается ОДИН раз — сразу скопировать в Secret. Повторно не посмотреть; при утере — выпустить новый.
   • Лимит — максимум 3 активных ключа на магазин.

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

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

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

После получения обоих значений вернитесь к форме настройки в вашем магазине и вставьте:

1. Merchant ID — в соответствующее поле.
2. API-ключ — в поле «API-ключ».

6. Необходимо выполнить следующие действия:

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

7. Завершение заполнения параметров

Внизу формы расположены две кнопки:

«Назад» — нажмите, чтобы вернуться к выбору способа оплаты (введённые данные не сохранятся).

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

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

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

После сохранения способа оплаты обязательно настройте webhook в личном кабинете Яндекс Пэй. Он нужен, чтобы магазин автоматически получал уведомление об успешной или неуспешной оплате заказа.

В поле Callback URL укажите полный адрес webhook. Он строится из домена вашего магазина и пути /api/v2/yandexpay/webhook.

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

https://myshop.ru

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

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

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

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

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