Проверка действительности платёжного инструмента

Notice: Эта статья посвящена тому, как проверять действительность платёжных инструментов через платёжную платформу ecommpay и какие статусы при этом могут использоваться.

Помимо этой статьи для работы с проверкой действительности могут быть полезны:

  • статья Проверка платёжных инструментов с описанием того, как проверять действительность платёжных инструментов через Gate и какие запросы и оповещения при этом актуальны в случае прямой работы с платёжными картами;
  • статьи раздела Платёжные методы с описанием того, как проверять действительность платёжных инструментов через Gate при работе с различными платёжными методами и какие запросы и оповещения могут быть актуальны при этом.

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

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

Проверка действительности платёжного инструмента — это тип платежа, в рамках которого для проверки возможности использования платёжного инструмента на основании одного исходного запроса осуществляется один условный (нулевой) перевод денежных средств от пользователя к мерчанту или одна реальная (ненулевая) блокировка средств пользователя с последующей отменой. При этом сумма блокировки может согласовываться с мерчантом, а срок отмены блокировки может составлять до 45 дней.

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

Модель проведения

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

При проведении проверки платёжного инструмента дополнительно могут требоваться и другие запросы:

  • Если необходима аутентификация пользователя с использованием технологии 3‑D Secure, то от платформы к веб-сервису отправляется оповещение с информацией для формирования запроса к эмитенту, после чего проведение платежа в платформе приостанавливается до получения от веб-сервиса запроса с результатом аутентификации — 3ds_result.
  • Если необходимо уточнение информации для какой-либо из сторон, участвующих в проведении платежа (например, предоставление в платёжную систему адреса держателя карты, не переданного в исходном запросе), то от платформы к веб-сервису отправляется оповещение с названиями параметров для уточнения и проведение платежа в платформе приостанавливается до получения от веб-сервиса запроса с необходимой информацией — clarification.
Рис. 1. Диаграмма состояний проверки действительности платёжного инструмента

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

Статусы платежа

При проведении проверки действительности платёжного инструмента могут использоваться следующие статусы.

error Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа
processing Платёж проводится Промежуточное состояние
awaiting 3ds result Проведение платежа приостановлено до получения запроса на продолжение с учётом результата аутентификации 3‑D Secure — 3ds_result. Если такой запрос не получен в течение 30 минут, то платёж переводится в статус decline Промежуточное состояние
awaiting clarification Проведение платежа приостановлено до получения запроса на продолжение с учётом требуемой дополнительной информации — clarification. Если такой запрос не получен в течение 30 минут, платёж переводится в статус decline Промежуточное состояние
decline Платёж отклонён Конечное состояние
success Платёж проведён Конечное состояние

Статусы операции account verification

При выполнении операции account verification могут использоваться следующие статусы.

processing Операция выполняется Промежуточное состояние
awaiting 3ds result Выполнение операции приостановлено до получения запроса на продолжение с учётом результата аутентификации 3‑D Secure — 3ds_result. Если такой запрос не получен в течение 30 минут, операция переводится в статус decline Промежуточное состояние
awaiting clarification Выполнение операции приостановлено до получения запроса на продолжение с учётом требуемой дополнительной информации — clarification. Если такой запрос не получен в течение 30 минут, операция переводится в статус decline Промежуточное состояние
decline Операция отклонена Конечное состояние
success Операция выполнена Конечное состояние

Дополнительные материалы

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