Управление языком платёжной формы

Введение

Неотъемлемой частью пользовательского интерфейса Payment Page являются текстовые элементы: различные названия (полей, кнопок и других составляющих), подсказки и сообщения (в том числе об ошибках). Эти элементы обеспечивают полноту и понятность интерфейса и могут существенно влиять на пользовательский опыт и конверсию платёжной формы.

В Payment Page используются различные текстовые элементы, которые обеспечивают полноту и понятность интерфейса и могут существенно влиять на пользовательский опыт и конверсию платёжной формы.

Возможности

Чтобы тексты эффективно работали в Payment Page, специалисты Flashpay тщательно подбирают формулировки на разных языках и обеспечивают возможность использования любого языка из регулярно расширяемого базового набора. Вместе с тем, для разных мерчантов могут быть актуальны самые разные нюансы, и для того, чтобы лучшим образом адаптировать Payment Page к специфике конкретного проекта, со стороны мерчанта можно:

При работе с Payment Page обеспечивается возможность использования типовых формулировок на любом языке из регулярно расширяемого базового набора. Вместе с тем, в некоторых случаях может быть актуально:

• расширять рабочий набор языков — например, добавляя к английскому из базового набора валлийский и шотландский для адресной работы в соответствующих регионах Британии (подробнее);
• указывать необходимый для работы язык при вызове формы — например, с учётом того, какой язык выбрал пользователь в веб-сервисе (подробнее);
• предоставлять пользователям возможность смены языка при работе с формой — например, когда нет уверенности в предпочтениях пользователя, но есть понимание, какие языки актуальны для региона проведения платежа (подробнее).

В дополнение к описанным возможностям может быть актуальным и изменение оформления платёжной формы с помощью конструктора (подробнее). При этом важно учитывать, что как в случаях с изменением оформления, так и в случаях с добавлением языков и управлением языком платёжной формы ответственность за возможное негативное влияние на конверсию возлагается на мерчанта. Это может касаться неудобств на стороне пользователей из-за выбранной цветовой палитры, из-за недостаточно ясных формулировок на добавленных языках, из-за отсутствия возможности выбора актуального языка и прочих связанных факторов. Поэтому важно вдумчиво готовить и анализировать любые изменения и при необходимости возвращаться к проверенным вариантам работы.

При этом важно учитывать, что ответственность за возможное негативное влияние от применения таких возможностей на конверсию возлагается на мерчанта.

Порядок работы

По умолчанию, если в параметрах проекта не задано иное, платёжная форма открывается без возможности смены языка пользователем. При этом в ней используется (в порядке убывания приоритета):

1. Язык отображения платёжной формы, указанный при её вызове формы(подробнее), если он поддерживается для используемого проекта.
2. Язык браузера пользователя, если его удалось определить и он поддерживается для используемого проекта.
3. Язык региона открытия платёжной формы, если его удалось определить по IP-адресу пользовательского устройства и он поддерживается для используемого проекта.
4. Язык по умолчанию (в общем случае — английский).

Расширение набора языков

Чтобы добавить к базовому набору языков другие, со стороны мерчанта необходимо:

1. Запросить у специалистов технической поддержки тексты элементов платёжной формы, используемые в рамках проектов, для которых необходимо добавить новые языки.
2. Подготовить переводы на требуемые языки и предоставить их специалистам технической поддержки для встраивания в Payment Page.

   При необходимости на этом шаге также следует согласовать используемые наименования языков (для отображения в платёжной форме) и их коды (для использования в запросах). Для языков, входящих в стандарт ISO 639-1, в платформе используются наименования и коды в формате alpha-2 из этого стандарта, а для других языков — согласованные с мерчантом.

3. Получить уведомление о добавлении языков и принять результат. При этом можно проверить корректность отображения текстовых элементов платёжной формы с использованием новых языков на тестовом проекте.

Указание языка при вызове формы

Чтобы задать язык отображения платёжной формы для конкретного сеанса, при вызове формы необходимо передать код этого языка в формате alpha-2 стандарта ISO 639-1 в параметре language_code. В платёжной платформе используются коды, соответствующие формату alpha-2 стандарта ISO 639-1, и согласованные с мерчантами коды для тех языков, которые не входят в этот стандарт. Также стоит учитывать, что заданный при вызове формы язык используется и для формирования дополнительных уведомлений о событиях, связанных с этим платежом (если для проекта подключена соответствующая возможность; подробнее). Этот параметр влияет также и на выбор языка для уведомлений о проведении платежа (подробнее).

{
   "project_id": 93211,
   "payment_id": "423289",
   "payment_currency": "EUR",
   "payment_amount": 131970,
   "customer_id": "customer_772",
   "language_code": "de",    // код языка
   "signature": "TSzdE5rJZaA9TYAWEKoGpfXriFf82MxF..."
}

При таком способе задания языка платёжная форма открывается строго на языке из запроса. Это ведёт к следующим особенностям:

• если в запросе указан код языка, который не входит в рабочий набор языков проекта, для открытия платёжной формы и формирования уведомлений используется английский язык;
• если для проекта используется возможность смены языка пользователем и в запросе указан язык, которого нет среди доступных для выбора, то платёжная форма открывается на этом языке, а смена языка для этого сеанса не поддерживается.

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

При использовании типового оформления платёжной формы от Flashpay можно подключить возможность смены языка пользователем. В этом случае на страницы платёжной формы добавляется выпадающий список с названиями доступных языков и пользователь может выбирать из них любой подходящий.

Для этой возможности смены языка пользователем актуальны следующие особенности:

• в тех случаях, когда язык, используемый пользователем в браузере, доступен и в выпадающем списке Payment Page, платёжная форма отображается на этом языке (если иной язык не указан в запросе);
• при указании в запросе языка, которого нет среди доступных для смены пользователем, платёжная форма отображается на этом языке и без выпадающего списка;
• при смене языка пользователем выполняется переход на страницу, с которой была открыта платёжная форма, а все предыдущие действия игнорируются.

Чтобы подключить эту возможность, со стороны мерчанта необходимо:

1. Сформировать перечень языков, доступных пользователям в выпадающем списке, и передать его специалистам технической поддержки для встраивания в Payment Page. В таком перечне обязательно должен быть английский, а также могут использоваться любые другие из рабочего набора языков.
2. Получить уведомление о добавлении языков и принять результат. При этом можно проверить корректность смены языков на тестовом проекте.

Базовый набор языков

Flashpay обеспечивает работу платёжной формы с использованием следующих языков.