Skip to content

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 необходимо придерживаться стандартного процесса проведения платежа. При этом:

Параметр Значение
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.