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

Общая информация

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

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

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

Особенности

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

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

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

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

  Такие отличия стоит иметь в виду, как минимум, в части допустимых форматов (подробнее далее).

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

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

Подключение

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

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

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

Использование

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

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

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

Формат данных

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

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

{
"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"
}
}