API документация · /yandex/pay · 18 документов
Яндекс Пэй API: Заказы, платежи и обратные вызовы
Найдите контракт создания заказа, проверьте статус платежа, параметры списания и возврата. Отдельно описаны запросы магазина к Яндекс Пэй и входящие JWT-вебхуки. Исходные спецификации и ссылки на официальные страницы сохранены.
Паспорт источника
- Service ID
/yandex/pay- Источник
- pay.yandex.ru — официальная документация
- Документов
- 18
- Состав
- 18 активных документов · 10 методов · 6 методов в истории
- Спецификация
- OpenAPI Yandex Pay API и Merchant API
- Проверка источника
- 03.11.2026
- Версия API
- 1.0.0 · из OpenAPI
Яндекс Пэй API — один из 23 API в Bridge8. Тот же поиск и MCP-сервер работают для VK, Яндекса, Битрикс24, Авито и других:
Весь каталог: 31 источник →Что включено
18 документов Яндекс Пэй API в одном поиске
Сохранённые копии pay.yandex.ru: страницы документации и спецификация OpenAPI Yandex Pay API и Merchant API. У каждого документа — ссылка на официальную страницу и дата импорта.
Заказы и операции
9Создание заказа, чтение статуса, списание, отмена и возврат v2. Параметры запросов, схемы и ответы из OpenAPI.
- POST /api/merchant/v1/orders
- POST /api/merchant/v2/orders/{order_id}/refund
Входящие вебхуки
1События о состоянии заказа и операции, формат уведомлений и повторные отправки.
- POST /v1/webhook
- ORDER_STATUS_UPDATED
Авторизация и настройка
8Api-Key для магазина, JWT-проверка входящих запросов, настройки кабинета, тестовая среда, статусы и история API.
- Merchant ID и Callback URL
- ES256 и JWK
С чего начать
С чего начать интеграцию Пэй
Настройки из официального руководства личного кабинета.
- Откройте настройки магазинаПолучите Merchant ID и выпустите ключ Merchant API в личном кабинете Яндекс Пэй.
- Настройте серверУкажите Callback URL. Проверяйте подпись JWT входящих запросов по алгоритму ES256 с публичными JWK-ключами.
- Пройдите тестированиеИспользуйте настройки тестовой среды из документации. В ней в качестве API-ключа используется Merchant ID.
Два направления запросов
- Магазин → Пэй
- Api-Key
- Пэй → магазин
- JWT / ES256
Текущая документация не подтверждает OAuth-авторизацию с доступом yandexpay:merchant-api. Не заменяйте Api-Key OAuth-токеном на основании названия доступа.
pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/Документация
Частые задачи: методы и руководства
Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу pay.yandex.ru.
Заказы, платежи и вебхуки
6 из 10- POST
/api/merchant/v1/ordersСоздать заказ - GET
/api/merchant/v1/orders/{order_id}Получить заказ и статус оплаты - POST
/api/merchant/v1/orders/{order_id}/captureПодтвердить списание - POST
/api/merchant/v2/orders/{order_id}/refundВернуть платёж - GET
/api/merchant/v1/operations/{external_operation_id}Получить информацию об операции - POST
/v1/webhookПринять уведомление на сервере магазина
Подключение и проверка
6 из 8- Аутентификация запросов магазина
pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/ - Проверка входящих JWT
pay.yandex.ru/docs/ru/custom/backend/merchant-api/ - Настройки интеграции
pay.yandex.ru/docs/ru/console/settings-pay-split - Тестирование
pay.yandex.ru/docs/ru/testing - Статусы платежей
pay.yandex.ru/docs/ru/payments/statuses - История изменений API
pay.yandex.ru/docs/ru/custom/backend/changelog
Как использовать
Три способа работать с документацией Яндекс Пэй API
Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.
01 · На сайте
Поиск без регистрации
Выберите Яндекс Пэй API в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на pay.yandex.ru.
Яндекс Пэй API · 18 → merchant_v1_orders-post02 · ИИ-агент по MCP
Спросите Claude Code или Cursor
Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.
«Найди документацию Яндекс Пэй: как создать заказ, проверить оплату и принять вебхук? Укажи авторизацию каждого направления и официальные источники.»
resolve_service → search_docs → get_document03 · Документ целиком
Читайте страницу полностью
get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.
get_document → Создание заказа
Яндекс Пэй API /yandex/pay
POST /api/merchant/v1/orders
Контракт создания заказа из официальной OpenAPI. Параметры корзины, валюта и идентификатор заказа доступны в полном документе.
Подключение
Подключите документацию Яндекс Пэй API к ИИ-агенту
Один MCP-сервер Bridge8 — и агент знает Яндекс Пэй API и ещё 22 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.
Как подключить за минуту
- Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
- Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
- Спросите про Яндекс Пэй APIНайди API Яндекс Пэй и покажи создание заказа, возврат v2 и проверку JWT-вебхуков.
Bridge8 предоставляет документацию. Выпуск ключей и платёжные операции выполняются в Яндекс Пэй.
claude mcp add --transport http bridge8 \
https://bridge8.ru/mcp \
--header "Authorization: Bearer <TOKEN>"{
"mcpServers": {
"bridge8": {
"type": "http",
"url": "https://bridge8.ru/mcp",
"headers": {
"Authorization": "Bearer <TOKEN>"
}
}
}
}Инструменты сервера — в порядке вызова
resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.get_documentЧитает документ целиком, постранично, со ссылкой на источник.
Вопросы
Вопросы о Яндекс Пэй API
Можно ли использовать yandexpay:merchant-api вместо API-ключа?
Текущая официальная документация требует Authorization: Api-Key. Поддержка OAuth-доступа yandexpay:merchant-api в этих методах не подтверждена. Название доступа помогает найти сервис, но не заменяет контракт авторизации.
Кто вызывает Merchant API?
Методы обратных вызовов обслуживает сервер магазина. Яндекс Пэй присылает подписанный JWT; магазин проверяет его до обработки данных. Запросы магазина к Пэй используют отдельный Yandex Pay API.
Что происходит с устаревшими методами?
Пять callback-методов из раздела archive и возврат v1 сохранены в истории. Они доступны по ID документа, но исключены из обычного поиска. Для возвратов в активном корпусе представлен метод v2.
Откуда взяты версия и параметры?
Обе официальные спецификации заявляют версию 1.0.0. Сырые JSON сохранены вместе с хешами и датами скачивания. Нераскрытые шаблоны источника, например refund-min-sum, оставлены явно неподтверждёнными.
Ещё в Bridge8
Связанные источники и все API
Один поиск и один MCP-сервер для 23 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.
Другие API в Bridge8
22 API · 5 853 документаЯндекс
13 APIVK и MAX
3 APICRM, телефония, банк
3 APIОбъявления и рассылки
3 APIСправка и курсы
8 источниковСправка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.
Каталог на главной