Сбор данных о пользователях

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

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

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

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

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

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

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

Пользовательские сценарии

Для сбора дополнительных данных в платёжной форме используются соответствующие поля. Эти поля могут отображаться во всех случаях или только при необходимости и могут быть обязательными и необязательными для заполнения. Также могут отличаться варианты размещения дополнительных полей: они могут отображаться на странице указания реквизитов платёжного инструмента или следующей за ней отдельной странице (с учётом общего количества полей).

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

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

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


Выбор варианта отображения осуществляется следующим образом.

Тот или иной вариант отображения поля определяется исходя из двух свойств и наличия в запросе значения для этого поля.

Обязательность указания данных + + + +
Обязательность отображения поля + + + +
Передача значения в запросе + + + +
Вариант отображения поля 1 2 3 2 1 2 3 3

Подключение

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

  1. Определить, для каких проектов и каких платёжных методов по этим проектам актуально собирать дополнительные данные. И для каждого такого случая определить набор запрашиваемых данных и свойства соответствующих полей. В состав данных могут включаться различные параметры (подробнее — далее), а к свойствам каждого из требуемых полей относятся:
    • Обязательность заполнения и отображения.
    • Способ указания: через ввод с клавиатуры или через выбор из выпадающего списка.

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

    • Название: по умолчанию используются типовые названия, предоставляемые ecommpay, но можно задать и индивидуальные.

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

  2. Определить, для каких проектов и каких платёжных методов по этим проектам актуально собирать дополнительные данные. И для каждого такого случая определить набор запрашиваемых данных и свойства соответствующих полей:
    • Обязательность заполнения и отображения.
    • Способ указания: через ввод с клавиатуры или через выбор из выпадающего списка.
    • Название: по умолчанию используются типовые значения, предоставляемые ecommpay, но можно задать и индивидуальные.
  3. Передать специалистам технической поддержки информацию обо всех данных, которые требуется запрашивать у пользователей, а также информацию о том, необходимо ли получать данные, указанные пользователями в платёжной форме, в итоговых оповещениях о проведении платежей.
  4. Получить от специалистов ecommpay уведомление о подключении запрашиваемой функциональности и, при необходимости, проверить работу платёжной формы с её использованием.

Запрашиваемые данные

Для сбора данных о пользователях могут использоваться следующие параметры.

Параметр Описание

customer_address
string

Полный адрес проживания пользователя.
Представляет собой строку длиной не более 255 символов.
Пример: Вильнюс, улица Дукшту, 30

customer_birthplace
string

Место рождения пользователя.
Представляет собой строку длиной не более 255 символов.
Пример: Рига

customer_city
string

Название города проживания пользователя.
Представляет собой строку длиной не более 255 символов.
Пример: Вильнюс

customer_country
string

Код страны проживания пользователя в формате ISO 3166-1 alpha-2.
Пример: LT

customer_day_of_birth
string

Дата рождения пользователя в формате ДД-ММ-ГГГГ.
Пример: 17-04-1989

customer_email
string

Адрес электронной почты пользователя.
Представляет собой строку длиной не более 255 символов, состоящую из двух частей: имени пользователя и доменного имени, разделённых символом «@».
Пример: sonya@example.com

customer_first_name
string

Имя пользователя.
Представляет собой строку не более 255 символов.
Пример: Софья

customer_last_name
string

Фамилия пользователя.
Представляет собой строку не более 255 символов.
Пример: Ковалевская

customer_middle_name
string

Отчество пользователя.
Представляет собой строку не более 255 символов.
Пример: Васильевна

customer_phone
string

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

customer_ssn
integer

Последние 4 цифры номера социального страхования налогоплательщика в США.
Пример: 1312

customer_state
string

Название региона (штата) адреса проживания пользователя.
Представляет собой строку длиной не более 255 символов.
Пример: Вильнюсский уезд

customer_zip
string

Почтовый индекс адреса проживания пользователя.
Пример: LT-071171

billing_address
string

Название улицы расчётного адреса пользователя.
Представляет собой строку длиной не более 255 символов.
Пример: Дукшту

billing_city
string

Название города расчётного адреса пользователя.
Представляет собой строку  длиной не более 255 символов.
Пример: Вильнюс

billing_country
string

Код страны расчётного адреса пользователя в формате ISO 3166-1 alpha-2.
Пример: LT

billing_postal
string

Почтовый индекс расчётного адреса пользователя.
Представляет собой строку длиной не более 16 символов.
Пример: LT-071171

billing_region
string

Название региона расчётного адреса пользователя.
Представляет собой строку длиной не более 255 символов.
Пример: Вильнюсский уезд

billing_region_code
string

Код региона расчётного адреса пользователя в формате ISO 3166-2.
Пример: VL

Параметр Описание

customer_address
string

Полный адрес проживания пользователя.
Пример: Вильнюс, улица Дукшту, 30

customer_birthplace
string

Место рождения пользователя.
Пример: Рига

customer_city
string

Название города проживания пользователя.
Пример: Вильнюс

customer_country
string

Код страны проживания пользователя в формате ISO 3166-1 alpha-2.
Пример: LT

customer_day_of_birth
string

Дата рождения пользователя в формате ДД-ММ-ГГГГ.
Пример: 17-04-1989

customer_email
string

Адрес электронной почты пользователя.
Пример: sonya@example.com

customer_first_name
string

Имя пользователя.
Пример: Софья

customer_last_name
string

Фамилия пользователя.
Пример: Ковалевская

customer_middle_name
string

Отчество пользователя.
Пример: Васильевна

customer_phone
string

Номер телефона пользователя.
Пример: 44997654321

customer_ssn
integer

Последние 4 цифры номера социального страхования налогоплательщика в США.
Пример: 1312

customer_state
string

Название региона (штата) адреса проживания пользователя.
Пример: Вильнюсский уезд

customer_zip
string

Почтовый индекс адреса проживания пользователя.
Пример: LT-071171

billing_address
string

Название улицы расчётного адреса пользователя.
Пример: Дукшту

billing_city
string

Название города расчётного адреса пользователя.
Пример: Вильнюс

billing_country
string

Код страны расчётного адреса пользователя в формате ISO 3166-1 alpha-2.
Пример: LT

billing_postal
string

Почтовый индекс расчётного адреса пользователя.
Пример: LT-071171

billing_region
string

Название региона расчётного адреса пользователя.
Пример: Вильнюсский уезд

billing_region_code
string

Код региона расчётного адреса пользователя в формате ISO 3166-2.
Пример: VL

Использование дополнительных параметров, не представленных в таблице, можно согласовывать со специалистами ecommpay.