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

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

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

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

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

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

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

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.

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

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

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

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

Рис.: 1 — Открытие платёжной формы

Рис.: 2 — Указание данных платёжного инструмента

Рис.: 3 — Указание дополнительных данных

Схема работы

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

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

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

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

Для контроля платежей, при проведении которых выполнялась процедура дополнения информации можно использовать оповещения и сведения из карточек платежей, доступных в интерфейсе 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": "431422****0056",
      "type": "visa",
      "card_holder": "JOHN DOE",
      "expiry_month": "01",
      "expiry_year": "2023"
   },
   "customer": {
      "id": "3b6d6827-8cdd-4040"
   },
   "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": "c0f65543b97c062c8d4f975bfd397aef6aa55a71-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..."
}