Яндекс Пэй и Сплит: документация для партнёра¶

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

Неофициальная документация

Материалы написаны по публичной документации Яндекс Пэй и проверены в тестовой среде (Sandbox). Проект не связан с Яндексом. Ключи и идентификаторы в примерах заменены плейсхолдерами вида <MERCHANT_ID>.

С чего начать¶

Задача	Документ
Понять порядок интеграции	Подключение оплаты картой
Пройти весь сценарий в Sandbox	Сквозное тестирование
Вернуть один товар из заказа	Частичный возврат
Увидеть взаимодействие систем целиком	Сценарий оплаты через Сплит
Разобрать ошибку партнёра	На форме доступен только Сплит, Коды ошибок
Узнать, где API ведёт себя не так, как в документации	Отличия Sandbox от документации

Основные понятия¶

Мерчант: Магазин, который принимает оплату через Яндекс Пэй. У мерчанта есть идентификатор merchantId и API-ключ.
Заказ (order): Платёжная сессия, созданная методом POST /v1/orders. У заказа есть статус оплаты paymentStatus.
Операция (operation): Действие над заказом: списание, возврат, отмена. У операции есть свой тип operationType и свой статус status. Подробнее в разделе Статусы.
Callback URL: Адрес на бэкенде магазина, на который Яндекс Пэй отправляет вебхуки. Путь /v1/webhook Яндекс Пэй добавляет к нему сам.
Вебхук: POST-запрос от Яндекс Пэй о смене статуса заказа или операции. Тело запроса — JWT-токен, подписанный алгоритмом ES256.

Базовые адреса API¶

Среда	Base URL
Sandbox	`https://sandbox.pay.yandex.ru/api/merchant`
Production	`https://pay.yandex.ru/api/merchant`