Интеграция с Yandex Pay по API

Интеграция Yandex Pay состоит из нескольких этапов:

  1. Установка кнопки Yandex Pay на фронтенде продавца (подробнее в разделах для соответствующей платформы: Web, Android и iOS).
  2. Разработка взаимодействия между бэкендом продавца и Yandex Pay (подробнее в разделе Интеграция на бэкенде).
  3. Настройка параметров шлюза в консоли Yandex Pay.

Схема взаимодействия

Оформление покупки происходит по следующей схеме:

  1. Покупатель нажимает кнопку Yandex Pay.
  2. По номеру заказа или составу корзины Yandex Pay получает информацию о заказе и товарах через вызов order/render.
  3. На основе данных продавца и персональных данных пользователя Yandex Pay отображает форму оформления заказа.
  4. Покупатель выбирает способ доставки и инициирует оплату.
  5. Yandex Pay запрашивает разрешение на оплату заказа через вызов /order/create.
  6. Продавец проверяет детали заказа, резервирует товар и разрешает оплату.
  7. Yandex Pay проводит платеж через платежный шлюз продавца.
  8. Yandex Pay уведомляет продавца о статусе платежа через вызов /webhook.
  9. Покупатель видит статус оплаты и закрывает форму.

Покупатель перед оплатой может вносить изменения на форму: изменять адрес доставки, вводить купон на скидку. После каждого изменения бэкенд Yandex Pay будет повторять шаги 2-3.

Продавец может управлять заказом через Yandex Pay API: списывать средства для двухстадийных платежей, выполнять возврат и прочее.

ПокупательПокупательФронт продавцаФронт продавцаФорма Yandex PayФорма Yandex PayБэкенд Yandex PayБэкенд Yandex PayБэкенд продавцаБэкенд продавцаПлатежный шлюзПлатежный шлюз1. Клик по кнопке Yandex PayКорзина или номер заказа2. POST/order/renderЦены и варианты доставки3. Данные для формы4. Клик по кнопке Купить5. POST/order/create6. Разрешение на оплату7. Оплата через шлюз продавца8. Webhook со статусомСтатус оплаты9. Закрывает форму

План интеграции с Yandex Pay

  1. Зарегистрируйтесь в консоли Yandex Pay. Получите Merchant ID и настройте адрес вашего бэкенда в Callback URL на странице разработчика.
  2. Выполните интеграцию кнопки на фронтенде Web, Android, iOS. Установите окружение Sandbox в параметрах кнопки.
  3. Реализуйте обработку запросов Merchant API. После реализации данного шага можно создать тестовый заказ.
  4. Опционально реализуйте вызовы Yandex Pay API для управления заказом из админки продавца.