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

Общая информация

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

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

Возможности

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

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

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

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

1. Язык отображения платёжной формы, указанный при её вызове формы(подробнее), если он поддерживается для используемого проекта, а если этот язык не поддерживается — язык по умолчанию (английский).
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..."
}

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

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

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