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

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

Схема работы

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

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

  1. В проект подключаются параметры, которые необходимо собирать с пользователей, с указанием их видимости и обязательности.
  2. В объекте или запросе на Payment Page передаются параметры, значения которых известны или нуждаются в уточнении.
  3. Payment Page отображает пользователю поля для сбора данных в соответствии с настройками и переданными параметрами.
  4. Пользователь заполняет обязательные поля и, по желанию, необязательные поля и инициирует платеж.
  5. Payment Page передает полученные в запросе и внесенные пользователем данные в платежную платформу.

Возможность поддерживается при использовании скрипта шифрования карточных данных.

Табл. 1. Отображение полей в виджете в зависимости от настроек и переданных параметров
Поле обязательное? Поле скрывается? Наличие значения в запросе Результат
Поле не отображается, параметр пересылается в платежную платформу без изменений
Поле не отображается, параметр пересылается в платежную платформу без изменений
Отображается пустое поле, обязательное для заполнения. Указанное пользователем значение передается в платежную платформу
Поле не отображается, параметр не пересылается в платежную платформу
Отображается поле с переданным значением, обязательное для заполнения. Указанное пользователем значение передается в платежную платформу
Отображается поле с переданным значением, не обязательное для заполнения. Указанное пользователем значение передается в платежную платформу
Отображается пустое поле, обязательное для заполнения. Указанное пользователем значение передается в платежную платформу
Отображается пустое поле, необязательное для заполнения. Указанное пользователем значение (если оно было указано) передается в платежную платформу

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

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

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

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

Подключение

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

Для включения и настройки функциональности необходимо задать параметры, по которым вы хотите собирать данные. Можно выбрать только нужные вам параметры (или только один) или все. Для каждого параметра необходимо указать, будет ли он обязательным и будет ли он скрываться, а также название соответствующего параметру поля ввода в виджете 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 Электронная почта пользователя johndoe@example.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