Yandex Pay¶

Настоящий документ представляет собой руководство по использованию платежного метода Yandex Pay. Руководство определяет порядок действий для:

размещения кнопки Yandex Pay на странице оплаты веб-сайта;
осуществления информационного взаимодействия c целью совершения платежа.

Принцип работы способа оплаты Yandex Pay указан на сайте pay.yandex.ru.

Инструкция предназначена для компаний, осуществляющих прием платежей с помощью собственной платежной формы и взаимодействия с платформой RBK.money по API.

Если прием платежей осуществляется с помощью платежного виджета RBK.money, описанные ниже действия выполнять не требуется — способ оплаты Yandex Pay уже доступен для покупателей.

Размещение кнопки и обработчика событий Yandex Pay¶

Для добавления кнопки и обработчика событий Yandex Pay на страницу оплаты веб-сайта необходимо ознакомиться с официальной документацией Yandex и выполнить на уровне frontend действия, описанные в данной статье.

Информация

Для того, чтобы получить merchant_id необходимо пройти регистрацию в сервисе Yandex Pay.

Оплата с помощью Yandex Pay¶

Для совершения оплаты с помощью метода Yandex Pay необходимо придерживаться стандартного процесса проведения платежа. При этом:

при выборе данного метода покупатель должен нажать соответствующую кнопку на странице оплаты заказа: шаг 5 схемы проведения платежа;
запрос на токенизацию данных в Yandex Pay описан в разделе «Токенизация платежных данных в Yandex Pay»: шаг 6 схемы проведения платежа.
при формировании запроса на создание токена платежного средства (шаг 7 схемы проведения платежа) в объекте PaymentTool следует указать нижеприведенные значения.

Параметр	Значение
`provider`	YandexPay
`paymentToolType`	TokenizedCardData
`gatewayMerchantID`	Идентификатор мерчанта (продавца), выданный группой сопровождения RBK.money
`paymentToken`	Структура и значения, полученные от Yandex Pay

Токенизация платежных данных в Yandex Pay¶

Токенизация данных в Yandex Pay выполняется на шаге 6 схемы взаимодействия с RBK.money (он же - шаг 4 процесса оплаты в статье Yandex Pay Web SDK). Получение токена осуществляется путем передачи paymentData сервису Yandex Pay: см. в инструкции шаги «Создайте новый экземпляр платежа» и «Создайте кнопку Yandex Pay».

В случае подтверждения покупателем оплаты заказа сервис Yandex Pay создает для него платежный токен (PaymentToken). Yandex Pay отправляет созданный токен на frontend сайта продавца: см. ниже Callback. Полученный токен должен быть передан RBK.money при формировании платежного запроса: см. шаг 7 данной схемы взаимодействия.

Сallback

{
  "type": "process",
  "token": "eyJ******X19",
  "paymentMethodInfo": {
    "cardLast4": "0606",
    "cardNetwork": "MASTERCARD",
    "type": "CARD"
  }
}

Параметр	Описание	Значения/Примеры
`type`	Тип события	См. PaymentEventType
`token`	Значение токена платежных данных	eyJ**X19
`paymentMethodInfo`	Объект с информацией о банковской карте покупателя
`cardLast4`	Четыре последние цифры номера карты	0606
`cardNetwork`	Платежная система	См. AllowedCardNetwork
`type`	Метод оплаты	См. PaymentMethodType

Информация

∙ Тип события Error имеет причину с определенным кодом ошибки. C кодами ошибок можно ознакомиться на странице с описанием интерфейса YaPay: см. ErrorEventReason.
∙ Список разрешенных в Yandex Pay платежных систем может отличаться от списка разрешенных в RBK.money.