Дополнение информации о платеже

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

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

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

Запрашиваемые данные обычно представляют собой сведения о пользователе и его платёжном инструменте: для платежей с использованием платёжных карт это могут быть параметры объектов avs_data (для проверки Address Verification Service, AVS) и customer, а для платежей с использованием других платёжных методов — любые необязательные параметры из числа допустимых для исходного запроса на проведение платежа.

К запрашиваемым данным о пользователе могут относиться:

  • customer_first_name — имя;
  • customer_last_name — фамилия;
  • customer_middle_name — отчество или среднее имя пользователя;
  • customer_day_of_birth — дата рождения;
  • customer_email — адрес электронной почты;
  • customer_address — адрес проживания;
  • customer_city — город;
  • customer_country — страна;
  • customer_street — улица;
  • customer_zip — почтовый индекс.
Прим.: Итоговый набор запрашиваемых данных зависит от требований конкретного провайдера или платёжной системы и может варьироваться. Для уточнения набора запрашиваемых данных в зависимости от используемого платёжного метода следует обращаться к курирующему менеджеру ECommPay.

Для дальнейшего проведения платежа со стороны пользователя необходимо указывать все запрашиваемые данные. Информация о базовых действиях пользователя при дополнении информации о платеже представлена далее.

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

Базовый пользовательский сценарий проведения оплаты при дополнении информации о платеже можно представить следующим образом:

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

    При использовании ограничения времени работы с Payment Page на форме дополнительно отображается отсчёт времени.



  2. В результате того, что в платёжной платформе выявлена необходимость в дополнении данных, на Payment Page отображается страница с уведомлением и полями для ввода дополнительных данных. На этом шаге при задании ограничения времени работы с Payment Page начинается новый отсчёт времени. Подробнее об особенностях выполнения процедуры дополнения информации о платеже при ограничении времени работы с формой — в разделе Особенности применения.
  3. Пользователь указывает запрашиваемые данные и подтверждает готовность продолжить проведение платежа.


Схема работы

Далее представлена схема выполнения процедуры дополнения информации о платеже.

Рис.: Схема взаимодействия



  1. При выявлении необходимости дополнения информации о платеже со стороны платёжной платформы формируется набор запрашиваемых данных.
  2. Пользователю отображается страница ввода дополнительных данных.
  3. Пользователь указывает запрашиваемые данные.
  4. Эти данные передаются в платёжную платформу.
  5. На стороне платёжной платформы выполняется обработка полученных данных, после чего проведение платежа продолжается стандартным образом.

Особенности применения

При использовании ограничения времени работы с Payment Page следует учитывать, что время на выполнение процедуры дополнения информации о платеже не включается в общее время работы пользователя с платёжной формой. Это означает, что при указании срока действия платёжной формы нет необходимости учитывать возможное выполнение процедуры дополнения информации. Время ожидания на ввод дополнительной информации установлено по умолчанию и составляет 30 минут с момента выявления необходимости дополнить данные. Если время ожидания истекло и данные не переданы в платформу — платёж автоматически отклоняется.

Для контроля платежей, при проведении которых выполнялась процедура дополнения информации можно использовать оповещения и сведения из карточки платежа, доступной в интерфейсе Dashboard (Old Dashboard) (подробнее — в разделе Контроль и проведение платежей). В промежуточных и итоговых оповещения, отправляемых со стороны платёжной платформы содержится набор данных, запрашиваемых у пользователя во время процедуры дополнения информации о платеже, а также статус платежа awaiting_clarification. Так, в следующем примере в качестве дополнения информации о платеже запрашивается адрес пользователя, необходимый для дальнейшего проведения оплаты с использованием платёжной карты.

Рис.: Пример оповещения

{
   "project_id":1173,
   "payment":{
      "id":"15557465346",
      "type":"purchase",
      "status":"awaiting clarification",    // статус платежа
      "date":"2020-07-30T10:20:58+0000",
      "method":"card",
      "sum":{
         "amount":131970,
         "currency":"USD"
      },
      "description":""
   },
   "account":{
      "number":"424242******4242",
      "type":"visa",
      "card_holder":"JOHN DOE",
      "expiry_month":"01",
      "expiry_year":"2023"
   },
   "customer":{
      "id":"3b6d6827-8cdd-4040-aaf6-0a8f81b95c31"
   },
   "clarification_fields":{     // запрашиваемые данные
      "avs_data":[
         "avs_address"
      ]
   },
   "operation":{
      "id":72658000000461,
      "type":"sale",
      "status":"awaiting clarification",
      "date":"2020-07-30T10:20:58+0000",
      "created_date":"2020-07-30T10:20:58+0000",
      "request_id":"c0f65543b97c062cf172cf04df239ee16ae27b34-9b1943e6454385d28d4f975bfd397aef6aa55a71-00072659",
      "sum_initial":{
         "amount":131970,
         "currency":"USD"
      },
      "sum_converted":{
         "amount":131970,
         "currency":"USD"
      },
      "code":"9999",
      "message":"Awaiting processing",
      "eci":"00",
      "provider":{
         "id":414,
         "payment_id":"",
         "endpoint_id":414
      }
   },
   "signature":"oFcRanmZ5FrWt8zQWqHM15PPWKV5eAfIErQXBS/1uMwzF1..."
}