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

Введение

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

Возможности

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

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

Рис.: Использование возможности смены языка

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

Работа по умолчанию

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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