Настройка виджета

В этом разделе описаны параметры и настройки, которые влияют на внешний вид и поведение платежного виджета.

Общий обзор виджета см. в разделе Обзор виджета. Порядок интеграции описан в разделе Порядок интеграции виджета.

Параметры, влияющие на отображение

Виджет настраивается комбинацией:

  • параметров заявки, передаваемых в API при создании платежа;

  • настроек проекта и кассы в кабинете мерчанта.

Ниже перечислены основные параметры, которые влияют на внешний вид и язык интерфейса.

Язык интерфейса

Язык интерфейса виджета определяется:

  • значением поля language в блоке данных о клиенте (например, customer.language);

  • либо значением языка по умолчанию для страны пользователя.

Поддерживаемые коды языка приведены в разделе Коды языков. Код языка задается в формате ISO 639-1 (например, ru, en, es).

Если язык в запросе не указан, система выбирает язык по умолчанию для страны пользователя. Соответствие стран и языков по умолчанию приведено в разделе Коды стран.

Валюта и сумма

Отображение суммы и валюты на виджете зависит от полей:

  • payment.amount — сумма платежа в дробных единицах валюты.

  • payment.currency — код валюты в формате ISO 4217 alpha-3 (например, RUB, KZT, UZS).

Правила указания суммы и список поддерживаемых валют приведены в разделе Коды валют.

Страна пользователя

Страна пользователя передается в поле:

  • customer.country — код страны в формате ISO 3166-1 alpha-2 (например, RU, KZ).

Список поддерживаемых стран приведен в разделе Коды стран.

Страна влияет на:

  • доступные методы оплаты;

  • язык по умолчанию;

  • набор доступных банков и сценариев оплаты.

Предвыбор метода оплаты

Метод оплаты, предлагаемый пользователю на первом экране виджета, задается параметром:

  • payment:widget_method — код метода платежной страницы.

Поддерживаемые значения и соответствие сценариям оплаты приведены в разделе Методы виджета.

Примеры:

  • payin-p2p-card — предвыбор оплаты по номеру карты.

  • payin-p2p-sbp — предвыбор оплаты по номеру телефона (СБП).

  • payin-ecom-card — предвыбор оплаты банковской картой в e-commerce-сценарии.

Если payment:widget_method не указан, виджет может отобразить список доступных методов, исходя из настроек кассы и страны.

Рекомендуется:

  • явно указывать payment:widget_method для основных пользовательских сценариев;

  • сверять используемые значения с актуальным списком в разделе Методы виджета.

Предвыбор банка

Для отдельных методов оплаты, например, P2P или оплата по клику, возможно предвыбрать банк. Списки банков и их символы описаны в разделах:

Общая схема:

  • заявка создается с указанием метода оплаты (например, payin-p2p-card);

  • дополнительно передается символ банка (например, sberbank, t-bank, alfa-bank), согласованный при интеграции;

  • если банк предвыбран, шаг выбора банка на виджете пропускается.

Конкретное поле для передачи символа банка зависит от сценария и интеграции и настраивается совместно со специалистом HighHelp.

При использовании предвыбора банка рекомендуется:

  • использовать только символы банков из актуального списка;

  • учитывать, что предвыбор банка влияет на конверсию и доступность отдельных сценариев.

Взаимодействие с оповещениями

Настройки виджета не меняют набор полей в оповещениях, но влияют на:

  • сценарии изменения статусов;

  • набор возможных подстатусов и описаний.

Описание структуры оповещений и примеров обработки приведено в разделе Оповещения виджета. Общая модель статусов описана в разделе Типы операций и статусы, а коды статусов и подстатусов приведены в разделе Коды статусов.