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

Для выполнения запросов Payment Page обычно требуется минимальный набор параметров, необходимых для проведения платежа через выбранную пользователем платежную систему. При этом для сбора данных и статистики о пользователях вы можете передавать и (или) запрашивать дополнительные данные, например, телефон или электронную почту пользователя.

Схема работы

Payment Page поддерживает сбор данных по определенным параметрам. Для каждого параметра указывается, скрывается ли он от пользователя и является ли он обязательным. Обязательные параметры могут отображаться пользователю, даже если они были скрыты по умолчанию, если значение параметра не передано. Особенности отображения полей приведены в таблице Отображение полей в виджете в зависимости от настроек и переданных параметров.

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

  1. В проект подключаются параметры, которые необходимо собирать с пользователей, с указанием их видимости и обязательности.
  2. В объекте или запросе на Payment Page передаются параметры, значения которых известны или нуждаются в уточнении.
  3. Payment Page отображает пользователю поля для сбора данных в соответствии с настройками и переданными параметрами.
  4. Пользователь заполняет обязательные поля и, по желанию, необязательные поля и инициирует платеж.
  5. Payment Page передает полученные в запросе и внесенные пользователем данные на Gate.
  6. Вы видите данные пользователя и статистику в Old Dashboard.
Табл. 1. Отображение полей в виджете в зависимости от настроек и переданных параметров
Поле обязательное? Поле скрывается? Наличие значения в запросе Результат
+ + + Поле не отображается, параметр пересылается в Gate без изменений
+ + Поле не отображается, параметр пересылается в Gate без изменений
+ + Отображается пустое поле, обязательное для заполнения. Указанное пользователем значение передается в Gate
+ Поле не отображается, параметр не пересылается в Gate
+ + Отображается поле с переданным значением, обязательное для заполнения. Указанное пользователем значение передается в Gate
+ Отображается поле с переданным значением, не обязательное для заполнения. Указанное пользователем значение передается в Gate
+ Отображается пустое поле, обязательное для заполнения. Указанное пользователем значение передается в Gate
Отображается пустое поле, необязательное для заполнения. Указанное пользователем значение (если оно было указано) передается в Gate

Особенности отображения отдельных параметров

Для параметров customer_country и billing_country отображается список стран. Страна по умолчанию выбирается из списка, если передан соответствующий параметр.

Особенности верстки виджета

  • Названия полей могут быть изменены по требованию.
  • Если для сбора задан только один параметр, то поле отображается на шаге ввода данных для проведения платежа:


  • Если задано два или более параметров, то поля отображаются в отдельном окне:


В Old Dashboard

Данные пользователей, которые собираются на Payment Page, отображаются в карточках пользователей в Old Dashboard. Подробнее см. в Покупатели.

Подключение

Совет: Для подключения и настройки функциональности обратитесь в службу технической поддержки по адресу support@ecommpay.com.

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

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

Табл. 2. Пример списка параметров для настройки функциональности
Параметр Поле обязательное? Поле скрывается? Название поля в виджете
customer_email + По умолчанию

Собираемые параметры

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

Полный список параметров, поддерживаемых Payment Page, приведен в разделе Параметры открытия платежной формы Payment Page.

Табл. 3. Передаваемые параметры для сбора дополнительных данных о пользователе
Параметр Обязательность Формат Описание Пример
customer_first_name настраиваемая string Имя пользователя Инна
customer_middle_name настраиваемая string Отчество пользователя Ивановна
customer_last_name настраиваемая string Фамилия пользователя Малая
customer_phone настраиваемая string Телефон пользователя. Должен содержать от 4 до 24 цифр 74991234567
customer_email настраиваемая string Электронная почта пользователя smith@gmail.com
customer_country настраиваемая string Страна адреса пользователя в формате ISO 3166-1 alpha-2 RU
customer_state настраиваемая string Штат адреса пользователя Курская область
customer_city настраиваемая string Город адреса пользователя Курск
customer_address настраиваемая string Адрес пользователя Ленина ул., 2
customer_zip настраиваемая string Почтовый индекс пользоватея 305000
customer_day_of_birth настраиваемая string Дата рождения пользователя, ДД-ММ-ГГГГ 12-12-1990
customer_birthplace настраиваемая string Место рождения пользователя Курск
customer_ssn настраиваемая integer Последние 4 цифры номера социального страхования гражданина США 1234
billing_postal настраиваемая string Почтовый индекс платежного адреса пользователя 101000
billing_country настраиваемая string Страна платежного адреса пользователя в формате ISO 3166-1 alpha-2 RU
billing_region настраиваемая string Регион или штат платежного адреса пользователя Московская область
billing_city настраиваемая string Город платежного адреса пользователя Дубна
billing_address настраиваемая string Улица платежного адреса пользователя Ленина ул., 20