Базовая механика

Базовая механика — это минимальный набор методов API Яндекс Пэй, с которыми можно принимать оплату в онлайн-магазине. Механика не рассматривает методы, с которыми можно настроить платежи по подписке, холдирование средств или привязать карту к аккаунту, но дает основополагающее представление о том, как работает сервис под капотом.

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

Изучите эту страницу прежде, чем переходить к подключению других механик.

Примечание

Данная механика поддерживает все способы оплаты: полная оплата (банковской картой или СБП с кешбэком), в Сплит.

Как это работает?

Настройте бэкенд и фронтенд своего магазина так, чтобы выполнялись следующие этапы проведения оплаты.

Схема проведения оплаты

image

Формирование корзины

  1. Покупатель формирует корзину товаров на сайте продавца и нажимает кнопку оплаты Яндекс Пэй.

  2. События после нажатия кнопки:

    1. Yandex Pay SDK вызывает callback на фронтенде магазина.
    2. Фронтенд магазина создает заказ на бэкенде магазина.
    3. Бэкенд магазина передает заказ в бэкенд Яндекс Пэй методом /orders.
    4. В ответ бэкенд Яндекс Пэй возвращает ссылку для перенаправления покупателя на фронтенд проведения оплаты в Яндекс Пэй.
    5. Фронтенд магазина получает ссылку на заказ Пэй, которую транслирует в Yandex Pay SDK.
  3. Yandex Pay SDK загружает с бэкенда Яндекс Пэй информацию о корзине товаров, которую необходимо оплатить покупателю.

  4. Yandex Pay SDK отображает покупателю форму оплаты с информацией о корзине товаров.

    • В случае Web SDK: происходит перенаправление на полученную ссылку для оплаты.
    • В случае Mobile SDK: открывается формы для оплаты.

    Важно

    Запрещено встраивать Яндекс Пэй в WebView при подключении в мобильных приложениях. Это небезопасно.

Авторизация покупателя и оплата

  1. Покупатель авторизуется со своим Яндекс ID, если не был авторизован.

  2. Покупатель выбирает способ оплаты покупки (Пэй или Сплит) и нажимает Оплатить.

    • При оплате сразу с кешбэком пользователь выбирает сохраненную в Яндексе банковскую карту или СБП-привязку к счету.

    • Если выбран Сплит, то покупатель выбирает количество платежей и совершает первый платеж со своих привязанных карт либо привязывает новую.
  3. Яндекс Пэй проводит платеж, списывая денежные средства с выбранной карты покупателя.

  4. Яндекс Пэй уведомляет продавца о статусе платежа через вызов /webhook, если был настроен Callback URL. Также бэкенд магазина может самостоятельно получить статус заказа через запрос /orders/{order_id}.

    Статусы оплаты:

    PENDING

    Оплата в процессе. Повторите запрос позже.

    Статус не отправляется в уведомлениях.

    FAILED

    Оплата завершилась неудачей либо покупатель не успел привязать свою карту за отведенное ему время (параметр ttl).

    Терминальный неуспешный статус.

    CAPTURED

    Оплата прошла успешно.

    Терминальный успешный статус.

  5. Яндекс Пэй перенаправляет покупателя на полученные в методе /orders ссылки для успешных или неуспешных оплат.

  6. Деньги за покупку поступят продавцу на следующие сутки.

Возврат оплаты

Провести возврат можно двумя способами:

  • в личном кабинете в разделе Платежи;
  • при помощи запросов к API.