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

Введение

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

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

Возможности

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

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

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

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

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

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

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