Документация

Введение

Скрипт Payment Widget (Платежный виджет) - это low code скрипт, который позволяет разместить кнопки Apple Pay и Google Pay на странице магазина продавца - на страницах товаров и/или в корзине покупателя. Тем самым это позволяет клиенту оформить заказ в один клик на поддерживаемых устройствах без выхода с вашего домена.

Проблема, которую мы предлагаем решить

Длинные многоэтапные оформления заказов и формы для ввода данных карты с низкой конверсией негативно влияют на доход. Сокращение шагов и удержание покупателей на странице повышает показатель завершения и доверие.

О нашем решении

Встраивайте платежный виджет там, где намерение покупателя наивысшее (например, на странице товара), чтобы обойти корзину и завершить оплату с помощью защищенного встроенного кошелька. Никаких внешних перенаправлений. Типичная настройка занимает менее одного дня.

Основные преимущества

Оплата на странице: покупатели совершают оплату, не покидая ваш сайт
Встроенные кошельки: Apple Pay и Google Pay "из коробки"
Готово к SCA/PSD2: 3DS2 обрабатывается автоматически для карточных транзакций, когда это требуется вашим эквайером
Low-code интеграция: drop-in скрипт (быстро подключаемый скрипт), минимальная конфигурация
Сокращенный объем PCI: данные карт никогда не попадают на ваши серверы
Гибкие настройки и элементы пользовательского интерфейса: размещение, сумма, валюта, уведомления обратного вызова, стили и др.
Простое подтверждение домена Apple: пошаговая загрузка одного файла
Быстрый процесс интеграции: менее 1 дня

Подключение скрипта

Добавление файла

На странице продавца внутри тега <head> необходимо добавить ссылку на файл pay-buttons.js.

Скрипт pay-buttons.js должен находиться в папке pay-buttons, на том же уровне, что и папка merchants (с платежными страницами).

У объявления скрипта обязательно должен быть указан id="pay-buttons".

<head>
  ...
  <script
    src="https://abby.rbsuat.com/payment/pay-buttons/pay-buttons.js"
    id="pay-buttons">
  </script>
  ...
</head>

Инициализация

<script>
  document.addEventListener("DOMContentLoaded", function () {
    var widget = payButtonsWidget("containerId"); // где `containerId` — id DOM-элемента, куда будут добавлены кнопки
 
    widget.init({
      gatewayInfo: { // Информация для шлюза
        token: "i29v9o5hkmuv2590l7661p9vcu", // Токен продавца в MP2
        amount: 852300, // Сумма заказа в копейках (ну или в минорных единицах)
        returnUrl: "http\:\/\/yourwebsite.com\/success.html", // Целевой адрес после оплаты
        merchantLogin: "buttonApple",
      },
 
      applePay: { // Информация для ApplePay сессии
        merchantId: "yourwebsite.com", // идентификатор мерчанта в Apple
      },
 
      googlePay: {
        environment: "TEST",
      },
    });
  });
</script>

Параметры инициализации

Ниже представлен полный перечень параметров для инициализации скрипта.

Обязательность	Параметр	Тип	Описание
Необязательно	`cartItems`	Array of objects	Массив объектов для описания товаров в корзине. См. описание вложенных элементов ниже.
Необязательно	`appleButtonClass`	String	Имя класса, которые будет проставляться кнопке applePay для того, чтобы можно было её отдельно стилизовать или обратиться к ней. Значение по умолчанию: `pay-button_applepay`.
Обязательно	`applePay`	Object	Объект, содержащий информацию по сессии Apple. См. описание вложенных элементов ниже.
Необязательно	`debug`	Boolean	Если `true` - включается режим отладки, при этом будет показываться вся служебная информация под кнопкой. По умолчанию `false`.
Обязательно	`gatewayInfo`	Object	Объект, содержащий информацию для заказа в Платежном шлюзе. См. описание вложенных элементов ниже.
Обязательно	`googlePay`	Object	Объект, содержащий информацию по сессии Google Pay. См. описание вложенных элементов ниже.

Параметры блока cartItems

Обязательность	Название	Тип	Описание
Обязательно	`name`	String [1..255]	Наименование или описание товарной позиции в свободной форме.
Необязательно	`itemDetails`	Object	Объект с параметрами описания товарной позиции. Описание вложенных элементов приведено ниже.
Обязательно	`quantity`	Object	Элемент, описывающий общее количество товарных позиций одного `positionId` и его единицы измерения. Описание вложенных элементов приведено ниже.
Необязательно	`itemAmount`	Integer [1..12]	Сумма стоимости всех товарных позиций одного `positionId` в минимальных единицах валюты. `itemAmount` обязателен к передаче, только если не был передан параметр `itemPrice`. В противном случае передача `itemAmount` не требуется. Если же в запросе передаются оба параметра: `itemPrice` и `itemAmount`, то `itemAmount` должен равняться `itemPrice * quantity`, в противном случае запрос завершится с ошибкой.
Необязательно	`itemPrice`	Integer [1..18]	Сумма стоимости товарной позиции одного `positionId` в деньгах в минимальных единицах валюты.
Необязательно	`itemCurrency`	Integer [3]	Код валюты ISO 4217. Если не указан, считается равным валюте заказа.
Обязательно	`itemCode`	String [1..100]	Номер (идентификатор) товарной позиции в системе магазина.

Пример блока cartItems:

[
  {
    name: 'Pen',
    quantity: {
        value: 1,
        measure: "pcs"
    },
    itemAmount: (totalAmount * 100) / 2,
    itemCurrency: "643",
    itemCode: 'no_1'
  },
  {
    name: 'Cheese',
    quantity: {
        value: 1.4,
        measure: "kg"
    },
    itemAmount: (totalAmount * 100) / 2,
    itemCurrency: "643",
    itemCode: 'no_2'
  }
]

Параметры объекта gatewayInfo

Обязательность	Параметр	Тип	Описание
Обязательно	`token`	String	Токен продавца, который можно получить в консоли администратора. Нужен для идентификации продавца.
Необязательно	`registerPreAuth`	Boolean	Регистрация двухстадийного платежа. По умолчанию `false`.
Условие	`orderNumber`	String [1..36]	Номер заказа в системе магазина. Необязательно, если включена настройка "Генерировать номер заказа".
Необязательно	`amount`	Integer [0..12]	Сумма платежа в минимальных единицах валюты (например, в копейках).
Необязательно	`currency`	String [3]	Код валюты платежа ISO 4217. Если не указано, то используется значение по умолчанию. Допускаются только цифры.
Обязательно	`returnUrl`	String [1..512]	Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Адрес должен быть указан полностью, включая используемый протокол (например, `https://mybestmerchantreturnurl.com` вместо `mybestmerchantreturnurl.com`). В противном случае пользователь будет перенаправлен по адресу следующего вида: `https://abby.rbsuat.com/payment/<merchant_address>`. Адрес не должен быть относительным путем, т.е. он не должен начинаться с "." и "/". В противном случае будет возвращена ошибка 4: "URL возврата некорректен". Например: ../test.html, /test.html — неверные URL-адреса.
Необязательно	`failUrl`	String [1..512]	Адрес, на который требуется перенаправить пользователя в случае неуспешной оплаты. Адрес должен быть указан полностью, включая используемый протокол (например, `https://mybestmerchantreturnurl.com` вместо `mybestmerchantreturnurl.com`). В противном случае пользователь будет перенаправлен по адресу следующего вида: `https://abby.rbsuat.com/payment/<merchant_address>`. Адрес не должен быть относительным путем, т.е. он не должен начинаться с "." и "/". В противном случае будет возвращена ошибка 4: "URL возврата некорректен". Например: ../test.html, /test.html — неверные URL-адреса.
Необязательно	`description`	String [1..598]	Описание заказа в любом формате. Чтобы включить отправку этого поля в процессинговую систему, обратитесь в службу технической поддержки. В этом поле недопустимо передавать персональные данные или платежные данные (номера карт т.п.). Данное требование связано с тем, что описание заказа нигде не маскируется.
Необязательно	`clientId`	String [0..255]	Номер клиента (ID) в системе мерчанта — до 255 символов. Используется для реализации функциональности связок. Может возвращаться в ответе, если мерчанту разрешено создавать связки. Указание этого параметра при обработке платежей по связке обязательно. В противном случае платеж будет невозможен.
Необязательно	`sessionTimeoutSecs`	Integer [1..9]	Продолжительность жизни заказа в секундах. В случае если параметр не задан, будет использовано значение, указанное в настройках мерчанта, или время по умолчанию (1200 секунд = 20 минут). Если в запросе присутствует параметр `expirationDate`, то значение параметра `sessionTimeoutSecs` не учитывается.
Необязательно	`jsonParams`	Object	Набор дополнительных атрибутов произвольной формы, структура: `jsonParams={"param_1_name":"param_1_value",...,"param_n_name":"param_n_value"}` Могут быть переданы в Процесинговый Центр, для последующей обработки (требуется дополнительная настройка - обратитесь в поддержку). Некоторые предопределенные атрибуты jsonParams: `backToShopUrl` - добавляет на страницу оплаты кнопку, которая вернет держателя карты на URL-адрес переданный в этом параметре `backToShopName` - настраивает текстовую метку кнопки Вернуться в магазин по умолчанию, если она используется вместе с `backToShopUrl` `recurringFrequency` - минимальное количество дней между авторизациями. Требуется для создания рекуррентной связки, рекомендуется для создания связки рассрочки (если используется 3DS2, параметр обязателен). `recurringExpiry` - дата, после которой авторизации не разрешены, в формате ГГГГММДД. Требуется для создания рекуррентной связки, рекомендуется для создания связки рассрочки (если используется 3DS2, параметр обязателен). `paymentInfo` - для передачи информации по заказу в Банк и корректного построения Банковских отчётов следует передавать значение `paymentInfo` с использованием цифр, символов и букв латинского алфавита.
Необязательно	`orderBundle`	Object	Объект, содержащий корзину товаров. Описание вложенных элементов приведено ниже.
Необязательно	`merchantLogin`	String [1..255]	Чтобы зарегистрировать заказ от имени другого мерчанта, укажите его логин (для API-аккаунта) в этом параметре. Можно использовать, только если у вас есть разрешение на просмотр транзакций других продавцов или если указанный продавец является вашим дочерним продавцом.
Необязательно	`merchantName`	String	merchantFullName в платежном шлюзе. Нужен для отображения имени продавца в окне `payment request api`.
Необязательно	`dynamicCallbackUrl`	String [1..512]	Параметр для передачи динамического адреса для получения "платежных" callback-уведомлений по заказу, активированных для мерчанта (успешная авторизация, успешное списание, возврат, отмена, отклонение платежа по таймауту, отклонение card present платежа). "Не платежные" callback-уведомления (включение/выключение связки, создание связки), будут отправляться на статический callback адрес.
Необязательно	`ip`	String [1..39]	IP адрес плательщика. IPv6 поддерживается во всех запросах (до 39 символов). При использовании аутентификации 3DS 2 рекомендуем вам передавать в этом параметре реальный IP адрес клиента. Это позволит повысить конверсию в оплату на стороне ACS.
Необязательно	`expirationDate`	String [19]	Дата и время истечения срока действия заказа. Формат: `yyyy-MM-ddTHH:mm:ss`. Если этот параметр не передается в запросе, то для определения времени истечения срока действия заказа используется параметр `sessionTimeoutSecs`.
Необязательно	`postAddress`	String [1..255]	Адрес доставки.
Необязательно	`feeInput`	Integer [0..8]	Размер комиссии в минимальных единицах валюты. Функциональность должна быть включена на уровне продавца в шлюзе.
Условие	`email`	String [1..64]	Электронная почта для отображения на платежной странице. Если для продавца настроены уведомления клиента, электронную почту необходимо указать. Пример: `client_mail@email.com`. Адрес электронной почты не проверяется при регистрации, он будет проверен позже при оплате.
Необязательно	`billingPayerData`	Object	Блок с регистрационными данными клиента (адрес, почтовый индекс), необходимый для прохождения проверки адреса в рамках сервисов AVS/AVV. Обязательно, если функция включена для продавца на стороне Платежного шлюза. См вложенные параметры.
Необязательно	`shippingPayerData`	Object	Объект, содержащий данные о доставке клиенту. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`preOrderPayerData`	Object	Объект, содержащий данные предварительного заказа. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`orderPayerData`	Object	Объект, содержащий данные о плательщике заказа. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. См. вложенные параметры.
Необязательно	`billingAndShippingAddressMatchIndicator`	String [1]	Индикатор соответствия платежного адреса владельца карты и адреса доставки. Этот параметр используется для дальнейшей 3DS-аутентификации клиента. Возможные значения: `Y` - совпадение платежного адреса держателя карты и адреса доставки; `N` - платежный адрес владельца карты и адрес доставки не совпадают.

Ниже приведены параметры блока billingPayerData (данные об адресе регистрации клиента).

Обязательность	Название	Тип	Описание
Необязательно	`billingCity`	String [0..50]	Город, зарегистрированный по конкретной карте у Банка Эмитента.
Необязательно	`billingCountry`	String [0..50]	Страна, зарегистрированная по конкретной карте банка-эмитента. Формат: ISO 3166-1 (Alpha 2 / Alpha 3 / Number-3) или наименование страны. Рекомендуем передавать двух/трехбуквенный ISO код страны.
Необязательно	`billingAddressLine1`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента (адрес плательщика). Строка 1. Обязательно к передаче для AVS-проверки.
Необязательно	`billingAddressLine2`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 2.
Необязательно	`billingAddressLine3`	String [0..50]	Адрес, зарегистрированный по конкретной карте у Банка Эмитента. Строка 3.
Необязательно	`billingPostalCode`	String [0..9]	Почтовый индекс, зарегистрированный по конкретной карте у Банка Эмитента. Обязательно к передаче для AVS-проверки.
Необязательно	`billingState`	String [0..50]	Штат, зарегистрированный по конкретной карте у Банка Эмитента. Формат: полное значение кода ISO 3166-2, его часть или наименование штата/региона. Может содержать буквы только латинского алфавита. Рекомендуем передавать двухбуквенный ISO код штата/региона.

Описание параметров объекта shippingPayerData:

Обязательность	Название	Тип	Описание
Необязательно	`shippingCity`	String [1..50]	Город заказчика (из адреса доставки)
Необязательно	`shippingCountry`	String [1..50]	Страна заказчика
Необязательно	`shippingAddressLine1`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingAddressLine2`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingAddressLine3`	String [1..50]	Основной адрес клиента (из адреса доставки)
Необязательно	`shippingPostalCode`	String [1..16]	Почтовый индекс клиента для доставки
Необязательно	`shippingState`	String [1..50]	Штат/регион покупателя (из адреса доставки)
Необязательно	`shippingMethodIndicator`	Integer [2]	Индикатор способа доставки. Возможные значения: `01` - доставка на платежный адрес держателя карты. `02` - доставка на другой адрес, проверенный Мерчантом. `03` - доставка по адресу, отличному от основного адреса держателя карты. `04` - отправка в магазин/самовывоз (адрес магазина должен быть указан в соответствующих параметрах доставки) `05` - Цифровое распространение (включает онлайн-сервисы и электронные подарочные карты) `06` - билеты на путешествия и мероприятия, которые нельзя доставить. `07` - Прочее (например, игры, цифровые товары, не подлежащие доставке, цифровые подписки и т. д.)
Необязательно	`deliveryTimeframe`	Integer [2]	Срок поставки товара. Возможные значения: `01` - цифровая дистрибуция `02` - доставка в тот же день `03` - доставка на следующий день `04` - доставка в течение 2-х дней после оплаты и позже.
Необязательно	`deliveryEmail`	String [1..254]	Целевой адрес электронной почты для доставки цифрового распространения. Предпочтительно передавать электронную почту в самостоятельном параметре запроса `email` (но если вы передадите его в этом блоке, к нему применятся те же правила).

Описание параметров объекта preOrderPayerData:

Обязательность	Название	Тип	Описание
Необязательно	`preOrderDate`	String [10]	Ожидаемая дата доставки (для предзаказанных покупок) в формате ГГГГММДД.
Необязательно	`preOrderPurchaseInd`	Integer [2]	Индикатор размещения клиентом заказа на доступную или будущую доставку. Возможные значения: `01` - возможна доставка; `02` - будущая доставка
Необязательно	`reorderItemsInd`	Integer [2]	Индикатор того, что клиент перебронирует ранее оплаченную доставку в составе нового заказа. Возможные значения: `01` - заказ размещается впервые; `02` - повторный заказ

Описание параметров объекта orderPayerData.

Обязательность	Название	Тип	Описание
Необязательно	`homePhone`	String [7..15]	Домашний телефон владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.`
Необязательно	`workPhone`	String [7..15]	Рабочий телефон владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.`
Необязательно	`mobilePhone`	String [7..15]	Номер мобильного телефона владельца карты. Необходимо всегда указывать код страны, но знак `+` или `00` в начале можно указать или опустить. Номер должен иметь длину от 7 до 15 цифр. Таким образом, возможны следующие значения: `+35799988877`; `0035799988877`; `35799988877.` Для платежей по VISA с 3DS авторизацией необходимо указать либо электронную почту, либо номер телефона владельца карты. Если у вас настроено отображение номера телефона на платежной странице и вы указали неверный номер телефона, клиент сможет исправить его на платежной странице.

Описание параметров в объекте orderBundle:

Обязательность	Название	Тип	Описание
Необязательно	`orderCreationDate`	String [19]	Дата создания заказа в формате `YYYY-MM-DDTHH:MM:SS`.
Необязательно	`customerDetails`	Object	Блок, содержащий атрибуты клиента. Описание атрибутов тега приведено ниже.
Обязательно	`cartItems`	Object	Объект, содержащий атрибуты товаров в корзине. Описание вложенных элементов приведено ниже.

Описание параметров в объекте customerDetails:

Обязательность	Название	Тип	Описание
Необязательно	`contact`	String [0..40]	Предпочитаемый клиентом способ связи.
Необязательно	`fullName`	String [1..100]	ФИО плательщика.
Необязательно	`passport`	String [1..100]	Серия и номер паспорта плательщика в следующем формате: `2222888888`
Необязательно	`deliveryInfo`	Object	Объект, содержащий атрибуты адреса доставки. Описание вложенных элементов приведено ниже.

Описание параметров в объекте deliveryInfo:

Обязательность	Название	Тип	Описание
Необязательно	`deliveryType`	String [1..20]	Способ доставки.
Обязательно	`country`	String [2]	Двухбуквенный код страны доставки.
Обязательно	`city`	String [0..40]	Город назначения.
Обязательно	`postAddress`	String [1..255]	Адрес доставки.

Описание параметров в объекте cartItems:

Обязательность	Название	Тип	Описание
Обязательно	`items`	Object	Элемент массива с атрибутами товарной позиции. Описание вложенных элементов приведено ниже.

Описание параметров в объекте items:

Обязательность	Название	Тип	Описание
Обязательно	`positionId`	Integer [1..12]	Уникальный идентификатор товарной позиции в корзине.
Обязательно	`name`	String [1..255]	Наименование или описание товарной позиции в свободной форме.
Необязательно	`itemDetails`	Object	Объект с параметрами описания товарной позиции. Описание вложенных элементов приведено ниже.
Обязательно	`quantity`	Object	Элемент, описывающий общее количество товарных позиций одного `positionId` и его единицы измерения. Описание вложенных элементов приведено ниже.
Необязательно	`itemAmount`	Integer [1..12]	Сумма стоимости всех товарных позиций одного `positionId` в минимальных единицах валюты. `itemAmount` обязателен к передаче, только если не был передан параметр `itemPrice`. В противном случае передача `itemAmount` не требуется. Если же в запросе передаются оба параметра: `itemPrice` и `itemAmount`, то `itemAmount` должен равняться `itemPrice * quantity`, в противном случае запрос завершится с ошибкой.
Необязательно	`itemPrice`	Integer [1..18]	Сумма стоимости товарной позиции одного `positionId` в деньгах в минимальных единицах валюты.
Необязательно	`depositedItemAmount`	String [1..18]	Сумма списания для одного `positionId` в минимальных единицах валюты (например, в копейках).
Необязательно	`itemCurrency`	Integer [3]	Код валюты ISO 4217. Если не указан, считается равным валюте заказа.
Обязательно	`itemCode`	String [1..100]	Номер (идентификатор) товарной позиции в системе магазина.

Описание параметров в объекте quantity:

Обязательность	Название	Тип	Описание
Обязательно	`value`	Number [1..18]	Количество товарных позиций данного `positionId`. Для указания дробных чисел используйте десятичную точку. Допускается максимально 3 знака после точки.
Обязательно	`measure`	String [1..20]	Единица измерения количества по позиции.

Описание параметров в объекте itemDetails:

Обязательность	Название	Тип	Описание
Необязательно	`itemDetailsParams`	Object	Параметр, описывающий дополнительную информацию по товарной позиции. Описание вложенных элементов приведено ниже.

Описание параметров в объекте itemDetailsParams:

Обязательность	Название	Тип	Описание
Обязательно	`value`	String [1..2000]	Дополнительная информация по товарной позиции.
Обязательно	`name`	String [1..255]	Наименование параметра описания детализации товарной позиции

Параметры объекта applePay

Подробнее можно посмотреть в конструкторе кнопки https://applepaydemo.apple.com/

Обязательность	Параметр	Тип	Описание
Необязательно	`buttonStyle`	String	Стиль отображения кнопки. Допустимые значения: 'black', 'white', 'white-outline'. Значение по умолчанию: 'black'.
Необязательно	`paymentRequest`	String	Описание платежной сессии Apple Pay. Подробнее можно прочитать в официальной документации. См. пример ниже.
Необязательно	`paymentType`	String	Тип внешнего вида платежной кнопки. Допустимые значения: `plain`, `buy`, `donate`, `set-up`, `book`, `subscribe`. Значение по умолчанию: `buy`. Для типов `donate`, `book`, `subscribe` ширина кнопки должна быть как минимум 200 px.
Обязательно	`merchantId`	String	`merchantId` в Apple, например 'website.com'. Также этот сайт будет использоваться как `label` в окне Apple Pay. Так как оно ограничено по длине, то проще всего выводить домен сайта.
Обязательно	`language`	String [2]	Язык кнопки в формате ISO 639-1.

Пример paymentRequest:

{
  countryCode: 'BG',
  currencyCode: 'BGN',
  supportedNetworks: [
    'masterCard',
    'visa',
    'electron',
    'maestro'
  ],
  merchantCapabilities: [
    'supports3DS',
    'supportsCredit',
    'supportsDebit'
  ],
  total: {
    label: '',
    amount: 1.00 // major units
  },
  requiredShippingContactFields: [
    'postalAddress',
    'name',
    'phone',
    'email'
  ]
}

Параметры объекта googlePay

Обязательность	Параметр	Тип	Описание
Обязательно	`environment`	String	Окружение. Если его не указать, то кнопка GPay не будет отображаться. Допустимые значения: `PRODUCTION` - используется, чтобы показывать действительные способы оплаты, если для домена указан активный идентификатор продавца Google. Используется только для боевой среды. `TEST` - пробные способы оплаты, предназначенные для тестирования (по умолчанию).
Необязательно	`emailRequired`	Boolean	Спрашивать ли email при оплате через PaymentRequest API. Значение по умолчанию: `true`.
Необязательно	`phoneNumberRequired`	Boolean	Спрашивать ли телефон при оплате через PaymentRequest API. Значение по умолчанию: `true`.
Необязательно	`billingAddressRequired`	Boolean	Спрашивать ли адрес плательщика при оплате через PaymentRequest API. Значение по умолчанию: `true`.
Необязательно	`shippingAddressRequired`	Boolean	Спрашивать ли адрес доставки при оплате через PaymentRequest API. Значение по умолчанию: `false`.
Необязательно	`payerNameRequired`	Boolean	Спрашивать ли имя плательщика при оплате через PaymentRequest API. Значение по умолчанию: `false`.
Условие	`allowedCountryCodes`	Array of String	Cписок кодов стран в формате ISO 3166-1 alpha-2, где доступна доставка. Обязательно, если `shippingAddressRequired = true`.
Необязательно	`buttonColor`	String	Цвет кнопки Google Pay. Допустимые значения: `default` - выбранное значение по умолчанию. В настоящее время используется `black`. `black` - черная кнопка для размещения на белом или другом светлом фоне. `white` - белая кнопка для размещения на цветном фоне. Значение по умолчанию: `default`.
Необязательно	`buttonType`	String	Тип надписи на кнопке. Допустимые значения: `long` - кнопка с текстом "Оплатить через Google Pay" (по умолчанию). Если в настройках браузера пользователя выбран один из доступных языков, будет показана локализованная версия кнопки. `short` - кнопка оплаты через Google Pay без текста. Значение по умолчанию: `short`.

Генератор кода

Вы также можете быстро сгенерировать код для инициализации скрипта Payment Widget в Личном кабинете. Для этого перейдите на вкладку Быстрые кнопки -> Генератор кода в вашем Личном кабинете.

Данная страница имеет конструктор, который выглядит следующим образом:

Вкладка включает в себя следующие разделы для задания параметров инициализации скрипта:

Общие настройки - укажите общую информацию для регистрации заказа в Платежном шлюзе:
- Включить оплату через Apple Pay и/или Google Pay,
- Номер заказа,
- Сумма (обязательно),
- Валюта (выберите из списка),
- Язык (выберите из списка),
- Окружение (тестовое или рабочее)
- Страница успешного платежа и Страница неуспешного платежа (укажите URL или выберите стандартный URL).
Запрос пользовательских данных - укажите данные, которые будут обязательны во время платежа через PaymentRequest API для Google Pay. Установите соответствующие флажки: Имя, E-mail, Номер телефона, Почтовый адрес.
Настройки платежных кнопок - укажите тип внешнего вида и стиль кнопок Apple Pay и Google Pay. На вкладке доступен предварительный просмотр кнопки.
Код для вставки на вашу страницу - этот раздел содержит предварительный просмотр кода инициализации скрипта в соответствии с указанными параметрами. Этот код необходимо вставить на вашу страницу.

Поддержка браузерами

Программная среда / Браузеры	Apple Pay	Google Pay
iOS / iPadOS — Safari	Да	Да (веб-оформление)
iOS / iPadOS — Chrome / Edge / Firefox	Да	Да (веб-оформление)
macOS — Safari	Да	Да
macOS — Chrome / Edge / Firefox	Да, через QR (iOS 18+)	Да
Windows / Linux / ChromeOS — Chrome / Edge / Firefox	Да, через QR (iOS 18+)	Да
Android — Chrome / Edge / Firefox	Да, через QR (iOS 18+)	Да

Тестирование и внедрение

Тестовый стенд (UAT)

Подключить скрипт с адресом https://abby.rbsuat.com/payment/.

<script
  src="https://abby.rbsuat.com/payment/pay-buttons/pay-buttons.js"
  id="pay-buttons">
</script>

Продуктивный стенд (PROD)