Нямбот
НЯМБОТРуководство
О продуктеОткрыть CRM

Яндекс.Пэй

Яндекс.Пэй — платёжный сервис Яндекса для приёма онлайн-оплаты. Нямбот интегрирован с Яндекс.Пэй: покупатели оплачивают заказы прямо в мини-приложении, а возврат денег гостю ты делаешь кнопкой в СРМ (как это устроено).

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

Что потребуется#

  • ИП или ООО (организация должна существовать в базе ФНС не менее 2 дней)
  • Расчётный счёт в банке (для выплат)
  • Одобренная заявка на сервис «Яндекс Пэй и Сплит» (формат «Онлайн»)
  • Онлайн-касса для фискальных чеков (54-ФЗ) — см. Шаг 5

Шаг 1: Регистрация в Яндекс.Пэй#

  1. Войди или создай Яндекс ID на passport.yandex.ru (лучше на рабочую почту)
  2. Открой консоль console.pay.yandex.ru — форма регистрации откроется автоматически
  3. Нажми «Добавить», введи ИНН организации и выбери её из списка
  4. Проверь данные организации, подтверди телефон и почту
  5. В разделе Сервисы выбери «Яндекс Пэй и Сплит», формат «Онлайн»; укажи название, сайт, вид деятельности, БИК и реквизиты счёта, контактное лицо
  6. Отправь заявку и дождись одобрения — после этого появится доступ к API и тестированию

Шаг 2: Получение Merchant ID и Merchant API key#

Нямботу для подключения нужны два значения из консоли Яндекс.Пэй:

  • Merchant ID — идентификатор магазина
  • Merchant API key — ключ для авторизации запросов

Найти их можно в консоли Яндекс.Пэй в разделе настроек магазина.

Тестовый режим (песочница)#

Чтобы проверить оплату без реальных списаний, включи в консоли режим «Тестовые данные». В тестовом режиме значение Merchant API key совпадает с Merchant ID, а оплата проходит в песочнице Яндекса без реальной карты.

Боевой ключ включается отдельно после успешной проверки в тесте — это другое значение Merchant API key.

Шаг 3: Настройка в СРМ#

  1. Открой раздел Интеграции → таб «Оплата»
  2. Нажми на карточку «Яндекс.Пэй» → откроется форма
  3. Заполни:
    • Merchant ID — идентификатор магазина из консоли
    • Merchant API key — ключ из консоли (в тесте = Merchant ID)
    • Переключатель Боевой / Тест — поставь Тест для проверки в песочнице, Боевой для реальных платежей
    • Торговые точки — выбери одну или несколько ТТ (на каждую создаётся своя запись)
  4. Нажми «Добавить»

После сохранения в колонке «OAuth» будет «Подключено», а режим показан отдельным тегом — «Тест» или «Боевой». OAuth-подтверждение, как у ЮКассы, для Яндекс.Пэй не требуется — авторизация идёт по Merchant API key.

Одна ТТ — один эквайринг. Если на торговой точке уже подключена ЮКасса, Яндекс.Пэй на неё добавить нельзя (точка будет недоступна в списке). Сначала отвяжи прежний эквайринг.

⚠️ Вводи ключ аккуратно, без лишних пробелов и символов. Если ключ сохранён неверно, оплата вернёт ошибку «Не удалось создать платеж».

Шаг 4: Адрес уведомлений (Callback URL)#

Чтобы заказ подтверждался автоматически (даже если покупатель закрыл мини-приложение), пропиши адрес уведомлений в консоли Яндекс.Пэй.

Куда вводить: консоль Яндекс.Пэй → настройки магазина → Callback URL

Адрес (вводить ровно так):

https://api.nyambot.ru/api/webhooks/yandexpay-order

⚠️ Важно: указывай только базовый адрес выше. Яндекс.Пэй сам дописывает в конце /v1/webhook и шлёт уведомления на https://api.nyambot.ru/api/webhooks/yandexpay-order/v1/webhook. Не добавляй /v1/webhook вручную — иначе адрес задвоится и уведомления перестанут приходить.

Подробнее обо всех адресах → Адреса и URL.

Шаг 5: Чеки (54-ФЗ)#

В отличие от ЮКассы (у неё облачная касса встроена), Яндекс.Пэй сам чеки не фискализирует — для соблюдения 54-ФЗ нужно подключить онлайн-кассу (например, Атол Онлайн или CloudKassir) в консоли Яндекс.Пэй.

Важно: без подключённой кассы покупатель не получит фискальный чек, и ты нарушишь 54-ФЗ. Подключи кассу до приёма реальных платежей.

Тестирование оплаты#

В тестовом режиме (песочница):

  • Оформи заказ в мини-приложении и выбери «Онлайн» — откроется тестовая страница оплаты Яндекс.Пэй
  • Любая сумма по умолчанию завершается успешной оплатой; заказ автоматически переходит в статус оплачен
  • Проверь возврат: отмени заказ, затем открой его карточку в СРМ и нажми «Вернуть деньги гостю». Убедись, что в консоли Яндекс.Пэй в разделе «Возвраты» появилась запись

После успешной проверки в тесте переключи запись в СРМ в режим Боевой, введи боевой Merchant API key и проведи контрольную оплату на минимальную сумму с последующим возвратом.

Возвраты#

  • Автоматических возвратов нет. Отмена заказа — на кассе или в «Команде» — деньги не двигает: она заводит задачу на возврат, а деньги возвращает владелец кнопкой в СРМ.
  • Если заказ оплачен онлайн частично баллами лояльности, на карту возвращается только онлайн-часть; баллы возвращает касса iiko.
  • Возврат у Яндекс.Пэй подтверждается уведомлением (Callback URL), поэтому Шаг 4 обязателен и для возвратов.

Часто встречающиеся проблемы#

ПроблемаРешение
«Не удалось создать платеж»Проверь, что Merchant API key введён без лишних символов и соответствует режиму (Тест/Бой)
Заказ оплачен, но не подтверждается самПроверь Callback URL: только базовый адрес, без /v1/webhook вручную (Шаг 4)
Карта не списывается в тестеЭто нормально — в тестовом режиме оплата идёт в песочнице, без реального списания
Покупатель не получил чекПодключи онлайн-кассу в консоли Яндекс.Пэй (Шаг 5)

Связь с другими разделами#