# Использование сведений о мерчанте при проведении платежей {#ru_pp_descriptor}

статья о возможностях опосредованно предоставлять пользователям сведения о мерчантах через сервисы эмитентов при работе через Payment Page

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

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

По умолчанию сведения о каждом мерчантестатичны и включают в себялишь согласованное написание названия организации, однако по инициативе мерчанта к названию могут динамически добавляться и другие сведения,касающиеся конкретных операций или иных аспектов деятельности. Эти динамические части описаний могут указываться в запросах на открытие Payment Pageи ограничиваются только общей длиной строки и составом допустимых символов \(подробнее [далее](ru_pp_descriptor.md#section_b3f_hvp_13c)\).Так, в качестве сведений о мерчанте может указываться запись с названием организации и периодом бронирования услуги \(`Cosmotour* 17-19 feb`\) или с названием организации и забронированного отеля \(`Cosmotour* MarsSuite`\).

![](images/ecommpay/ru_gate_descriptor_2.svg "Указание периода бронирования")

![](images/ecommpay/ru_gate_descriptor_1.svg "Указание названия отеля")

Гибкое применение корректных и информативных сведений такого рода позволяет пользователям чётче идентифицировать мерчантов и платежи, а мерчантам — улучшать пользовательский опыт и снижать вероятность опротестования платежей со стороны пользователей.Работа с такими сведениями в рамках платёжной платформы Ecommpay актуальна для *карточных платежей* \(включая классические карточные платежи и методы Apple Pay, Click to Pay, Google Pay и Visa Instalments\) в отношении разовых и повторяемых оплат, проверок действительности платёжных карт и выплат.

## Особенности {#section_fhg_s3m_djc .section}

При работе со сведениями о мерчанте следует учитывать ряд особенностей:

-   Основное назначение сведений о мерчантах — помогать пользователям идентифицировать их операции и предотвращать неуместные опротестования.

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

-   Правила работы со сведениями о мерчантах могут отличаться для разных платёжных систем.

    Такие отличия стоит иметь в виду, как минимум, в части допустимых форматов \(подробнее [далее](ru_pp_descriptor.md#section_b3f_hvp_13c)\).

-   Порядок предоставления сведений о мерчантах пользователям определяется эмитентами.

    Состав и способ отображения итоговых сведений о мерчантах в уведомлениях, банковских выписках и иных материалах определяются правилами работы конкретных эмитентов. Это ведёт к тому, что сведения могут выглядеть по-разному как среди разных эмитентов, так и среди разных интерфейсов одного эмитента и среди разных типов операций в рамках одного интерфейса \(в частности, такие отличия могут касаться разных типов оплат и выплат, а также операций с использованием сервисов Mastercard MoneySend и Visa Direct\).


## Подключение {#section_ejd_vd3_1jc .section}

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

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

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

## Использование {#section_dh5_v5p_13c .section}

В тех случаях, когда для мерчанта актуально использование дополнительных сведений,в запросах на открытие Payment Page следует передавать соответствующий параметр:

-   для оплат и проверок действительности платёжных карт — `merchant_descriptor`;
-   для выплат — `sender_descriptor`.

Также стоит учитывать, что в случаях, когда значения параметров `merchant_descriptor` и `sender_descriptor` не соответствуют требуемому формату \([подробнее](ru_pp_descriptor.md#section_b3f_hvp_13c)\), в платформе может выполняться техническая корректировка таких значений\(в частности, с транслитерацией алфавитных символов и удалением недопустимых неалфавитных\) и это не приводит к отклонению инициируемых платежей. Вместе с тем, значения этих параметровне анализируются на стороне Ecommpay по содержанию, но могут анализироваться и использоваться в дальнейшем на стороне эмитентов. В связи с этим со стороны мерчанта важно обеспечивать техническую и содержательную корректность сведений, передаваемых в параметрах `merchant_descriptor` и `sender_descriptor`, в каждом случае их применения.

## Формат данных {#section_b3f_hvp_13c .section}

Допустимая длина используемых сведений о мерчанте ограничивается со стороны каждой платёжной системы. Так, Mastercard устанавливает максимальной длину в 22 символа, а Visa — в 25 символов.Все избыточные символы при этом отсекаются. Это стоит учитывать при формировании описаний наряду с ограничениями по допустимым символам. Допустимыми для параметров `merchant_descriptor` и `sender_descriptor` являются буквы базовой латиницы, цифры, пробел \(U+0020\) и следующие символы:

|`*`|U+002A|звёздочка \(астериск\)|
|`,`|U+002C|запятая|
|`-`|U+002D|дефис|
|`.`|U+002E|точка|
|`=`|U+003D|знак равенства|
|`_`|U+005F|нижнее подчёркивание|

Чтобы сформировать параметр `merchant_descriptor` или `sender_descriptor`, необходимо указатьсогласованный вариант названия организации и дополнительные сведения, разделив их звёздочкой \(`*`\) и пробеломи проверив соответствие ограничениям по длине строки.Например, если использовать название `Cosmotour` длиной в 9 символов \(и 2 символа в качестве разделителя\), допустимая длина для дополнительных сведений составит 11 символов для карт Mastercard и 14 символов для карт Visa — достаточно для записи вида `Cosmotour* to the Moon`.

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