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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Подключение

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

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

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

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

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

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

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

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

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

customer_birthplace
string

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

customer_middle_name
string

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

customer_ssn
integer

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

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_birthplace
string

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

customer_middle_name
string

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

customer_ssn
integer

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

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

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