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

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

В общем случае для проведения платежа в запросе на открытие 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 — почтовый индекс.

Прим.: Итоговый набор запрашиваемых данных зависит от требований конкретного провайдера или платежной системы и может варьироваться. Для уточнения набора запрашиваемых данных следует обращаться к курирующему менеджеру Rocketpay.

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

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

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

Пользователь подтверждает готовность выполнить целевое действие, например, провести оплату, после чего на Payment Page отображается страница ожидания.
При использовании ограничения времени работы с Payment Page на форме дополнительно отображается отсчет времени.
В результате того, что в платежной платформе выявлена необходимость в дополнении данных, на Payment Page отображается страница с уведомлением и полями для ввода дополнительных данных. На этом шаге при задании ограничения времени работы с 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":"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..."
}