API ЮKassa
Помощь
Подключить ЮKassa
Оплата через внешние платежные системы
Сценарий взаимодействия магазина и сервиса ЮKassa при оплате заказа через SberPay: оплата по смс или через мобильное приложение СберБанк Онлайн, Альфа-Клик, QIWI Wallet (далее — внешняя платежная система, ВПС) отличается от базового сценария.
Схема взаимодействия
Процесс оплаты
Шаг 1. Пользователь выбирает способ оплаты (на сайте магазина или на стороне ЮKassa) и нажимает «Оплатить».
Шаг 2. Данные, которые вводит пользователь, передаются в ЮKassa.
Шаги 3-4. Пользователя просят ввести данные для оплаты, обязательные для выбранной ВПС.
При оплате через SberPay есть три варианта:
  1. Пользователь переходит в ЮKassa и вводит дополнительные данные (как в этом сценарии).
  2. Пользователь подтверждает платеж по смс или по пуш-уведомлению в телефоне, на котором установлено мобильное приложение СберБанка. Магазин отправляет в ЮKassa запрос на создание счета (createInvoice), указывает invoiceType=sberbank и payMethod=offline. Если у пользователя на телефоне установлено мобильное приложение СберБанка, пользователь получает пуш-уведомление, переходит по нему в приложение и там подтверждает платеж. Если приложение не установлено, пользователь получает смс со счетом от СберБанка и подтверждает оплату ответным сообщением. Пользователь получает смс со счетом от СберБанка и подтверждает оплату ответным сообщением. См. Оплата по счету в смс
  3. Пользователь при оплате на мобильном устройстве переходит в мобильное приложение СберБанк Онлайн прямо со страницы магазина. Магазин отправляет в ЮKassa запрос на создание счета (createInvoice), указывает invoiceType=sberbank и payMethod=online. В ответ получает ссылку для редиректа (в параметре externalPaymentUrl) и самостоятельно перенаправляет по ней пользователя. Пользователь авторизуется в приложении СберБанк Онлайн и оплачивает выставленный счет. После оплаты приложение СберБанка автоматически перенаправляет его в ваш магазин. См. Метод createInvoice
Шаги 5-7. ЮKassa передает ВПС сумму к оплате и набор сведений о товаре и пользователе (если нужно).
Шаг 8. Пользователь переходит в интерфейс ВПС для проведения оплаты.
Шаги 9-11. Дальше платеж проходит внутри ВПС: отображение данных о товаре, способ подтверждения оплаты, информирование пользователя о результате операции, а также возможность редиректа пользователя на сайт магазина после завершения оплаты зависит от конкретной ВПС.
Шаги 12-17. Проверка заказа (вызов checkOrder) может осуществляться до выставления счета или в процессе платежа. Во втором случае после получения от ВПС информации о том, что пользователь оплатил счет, ЮKassa выполняет последовательные запросы Проверка заказа (checkOrder) и Уведомление о переводе (paymentAviso).
Что почитать еще
Платежная формаОбщее описание взаимодействияОбработка HTTP-уведомлений