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

Введение

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

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

Возможности

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

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

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

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

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

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

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

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

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

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

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

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

Добавление собственных формулировок

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

Процедура добавления индивидуальных формулировок схожа с процедурой расширения набора языков. Со стороны мерчанта необходимо:

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

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

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

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

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

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

Чтобы задать язык отображения платёжной формы для конкретного сеанса, при её вызове необходимо передать код этого языка в формате 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 можно подключить возможность смены языка пользователем. В этом случае на страницы платёжной формы добавляется выпадающий список с названиями доступных языков и пользователь может выбирать из них любой подходящий.

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

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

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

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

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

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

Язык Код
Английский en
Арабский ar
Болгарский bg
Вьетнамский vi
Греческий el
Индонезийский id
Испанский es
Казахский kk
Китайский zh
Корейский ko
Латышский lv
Литовский lt
Малайский ms
Немецкий de
Польский pl
Португальский pt
Русский ru
Тайский th
Турецкий tr
Французский fr
Хинди hi
Японский ja