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

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

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

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

По умолчанию сведения о каждом мерчантестатичны и включают в себялишь согласованное написание названия организации, однако по инициативе мерчанта к названию могут динамически добавляться и другие сведения,касающиеся конкретных операций или иных аспектов деятельности. Эти динамические части описаний могут указываться в запросах на проведение платежейи ограничиваются только общей длиной строки и составом допустимых символов \(подробнее [далее](ru_gate_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_gate_descriptor.md#section_b3f_hvp_13c)\).

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

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


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

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

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

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

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

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

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

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

-   для разовых оплат в одну стадию с указанием реквизитов карт или „сетевых токенов“ —[/v2/payment/card/sale](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-sale)
-   для разовых оплат в одну стадию с указанием внутренних токенов платёжной платформы —[/v2/payment/card/sale/token](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-sale-token)
-   для разовых оплат в две стадии с указанием реквизитов карт или „сетевых токенов“ —[/v2/payment/card/auth](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-auth)
-   для разовых оплат в две стадии с указанием внутренних токенов платёжной платформы —[/v2/payment/card/auth/token](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-auth-token)
-   для повторяемых оплат всех типов —[/v2/payment/card/recurring](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-recurring)
-   для выплат с указанием реквизитов карт —[/v2/payment/card/payout](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-payout)
-   для выплат с указанием внутренних токенов платёжной платформы —[/v2/payment/card/payout/token](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-payout-token)
-   для проверок действительности платёжных карт с указанием их реквизитов или „сетевых токенов“ —[/v2/payment/card/account\_verification](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-account-verification)
-   для проверок действительности платёжных карт с указанием внутренних токенов платёжной платформы —[/v2/payment/card/account\_verification/token](https://api-developers.ecommpay.com/api-specification/card-payments/post-v2-payment-card-account-verification-token)

-   для разовых оплат в одну стадию —[/v2/payment/applepay/sale](https://api-developers.ecommpay.com/api-specification/apple-pay/post-v2-payment-applepay-sale)
-   для разовых оплат в две стадии —[/v2/payment/applepay/auth](https://api-developers.ecommpay.com/api-specification/apple-pay/post-v2-payment-applepay-auth)

-   для разовых оплат в одну стадию —[/v2/payment/googlepay/sale](https://api-developers.ecommpay.com/api-specification/google-pay/post-v2-payment-googlepay-sale)
-   для разовых оплат в две стадии —[/v2/payment/googlepay/auth](https://api-developers.ecommpay.com/api-specification/google-pay/post-v2-payment-googlepay-auth)

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

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

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

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

``` {#codeblock_m2w_r5h_23c .language-json}

{
"payment": {
"amount": 1000,
"currency": "EUR",
"description": "Payout"
},
"general": {
"project_id": 91348,
"payment_id": "135113521354",
"signature": "iehD3ZeW3CM7aGfmdgfjdgneHbCmronMpXom1b/ot1HvOGMV+CT8LA=="
},
"customer": {
"id": "16061313",
"ip_address": "93.47.230.225",
"first_name": "John",
"last_name": "Doe"
},
"sender": {
"descriptor": "Cosmotour* to the Moon" // сведения о мерчанте
},
"card": {
"save": false,
"pan": "4314220000000056"
}
}

```

**На уровень выше:**[Дополнительные возможности](ru_Gate_Additional_capabilities.md)