Сбор данных о пользователе
Для выполнения запросов Payment Page обычно требуется минимальный набор параметров, необходимых для проведения платежа через выбранную пользователем платежную систему. При этом для сбора данных и статистики о пользователях вы можете передавать и (или) запрашивать дополнительные данные, например, телефон или электронную почту пользователя.
Схема работы
Payment Page поддерживает сбор данных по определенным параметрам. Для каждого параметра указывается, скрывается ли он от пользователя и является ли он обязательным. Обязательные параметры могут отображаться пользователю, даже если они были скрыты по умолчанию, если значение параметра не передано. Особенности отображения полей приведены в таблице Отображение полей в виджете в зависимости от настроек и переданных параметров.
Общая схема сбора дополнительных параметров выглядит следующим образом.
- В проект подключаются параметры, которые необходимо собирать с пользователей, с указанием их видимости и обязательности.
- В объекте или запросе на Payment Page передаются параметры, значения которых известны или нуждаются в уточнении.
- Payment Page отображает пользователю поля для сбора данных в соответствии с настройками и переданными параметрами.
- Пользователь заполняет обязательные поля и, по желанию, необязательные поля и инициирует платеж.
- Payment Page передает полученные в запросе и внесенные пользователем данные на Gate.
- Вы видите данные пользователя и статистику в Old Dashboard.
Возможность поддерживается при использовании скрипта шифрования карточных данных.
Поле обязательное? | Поле скрывается? | Наличие значения в запросе | Результат |
---|---|---|---|
+ | + | + | Поле не отображается, параметр пересылается в Gate без изменений |
– | + | + | Поле не отображается, параметр пересылается в Gate без изменений |
+ | + | – | Отображается пустое поле, обязательное для заполнения. Указанное пользователем значение передается в Gate |
– | + | – | Поле не отображается, параметр не пересылается в Gate |
+ | – | + | Отображается поле с переданным значением, обязательное для заполнения. Указанное пользователем значение передается в Gate |
– | – | + | Отображается поле с переданным значением, не обязательное для заполнения. Указанное пользователем значение передается в Gate |
+ | – | – | Отображается пустое поле, обязательное для заполнения. Указанное пользователем значение передается в Gate |
– | – | – | Отображается пустое поле, необязательное для заполнения. Указанное пользователем значение (если оно было указано) передается в Gate |
Особенности отображения отдельных параметров
Для параметров customer_country и billing_country отображается список стран. Страна по умолчанию выбирается из списка, если передан соответствующий параметр.
Особенности верстки виджета
- Названия полей могут быть изменены по требованию.
- Если для сбора задан только один параметр, то поле отображается на шаге ввода данных для проведения платежа:
- Если задано два или более параметров, то поля отображаются в отдельном окне:
В Old Dashboard
Данные пользователей, которые собираются на Payment Page, отображаются в карточках пользователей в Old Dashboard. Подробнее см. в Покупатели.
Подключение
Для включения и настройки функциональности необходимо задать параметры, по которым вы хотите собирать данные. Можно выбрать только нужные вам параметры (или только один) или все. Для каждого параметра необходимо указать, будет ли он обязательным и будет ли он скрываться, а также название соответствующего параметру поля ввода в виджете Payment Page.
Полный список поддерживаемых параметров приведен в Передаваемые параметры для сбора дополнительных данных о пользователе ниже.
Параметр | Поле обязательное? | Поле скрывается? | Название поля в виджете |
---|---|---|---|
customer_email | + | – | По умолчанию |
Собираемые параметры
Параметры, по которым возможен сбор дополнительных данных, приведены в таблице ниже. Обязательность этих параметров определяется в соответствии с настройкой функциональности при подключении.
Полный список параметров, поддерживаемых Payment Page, приведен в разделе Параметры открытия платежной формы Payment Page.
Параметр | Обязательность | Формат | Описание | Пример |
---|---|---|---|---|
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 |