# Управление языком платёжной формы {#ru_PP_WigetLanguages .concept}

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

## Общая информация {#section_xvl_zxc_dbb .section}

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

![](images/ecommpay/pp_wigetlanguages_1.svg)

## Возможности {#section_asl_ngx_nqb .section}

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

![](images/ecommpay/pp_wigetlanguages_2.svg "Использование возможности смены языка")

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

## Порядок работы {#section_hhb_qgx_nqb .section}

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

1.  Языкотображения платёжной формы, указанный при еёвызове \([подробнее](ru_PP_WigetLanguages.md#section_bb1_jft_kqb)\), если он поддерживается для используемого проекта, а если этот язык не поддерживается — язык по умолчанию \(английский\).
2.  Язык браузера пользователя, если его удалось определить\(через свойства браузера\) и он поддерживается для используемого проекта.
3.  Английский как язык по умолчанию.

## Указание языка при вызове формы {#section_bb1_jft_kqb .section}

Чтобы задать язык отображения платёжной формы для конкретного сеанса, при вызове формы необходимо передать код этого языка в параметре `language_code`. В платёжной платформе используются коды, соответствующие формату alpha-2 стандарта [ISO 639-1](https://www.iso.org/ru/iso-639-language-codes.html), и согласованные с мерчантами коды для тех языков, которые не входят в этот стандарт.Также стоит учитывать, что заданный при вызове формы язык используется и для формирования дополнительных уведомлений о событиях, связанных с этим платежом \(если для проекта подключена соответствующая возможность; [подробнее](ru_gate_receipts.md#)\).

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

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

## Базовый набор языков {#section_qq2_xp5_p4b .section}

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

|Язык|Код|
|----|---|
|Английский|`en`|
|Испанский|`es`|
|Итальянский|`it`|
|Латышский|`lv`|
|Литовский|`lt`|
|Немецкий|`de`|
|Португальский|`pt`|
|Русский|`ru`|
|Украинский|`uk`|
|Французский|`fr`|
|Эстонский|`et`|

**На уровень выше:**[Вспомогательные процедуры и дополнительные возможности](ru_PP_Additional.md)