Оплата по платёжной ссылке

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

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

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

Схема проведения

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

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

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

  • Проведение оплаты (подробнее), с регистрацией повторяемой оплаты или без таковой. Для проведения этого варианта оплаты в платёжной платформе формируется операция sale, результатом выполнения которой является списание средств со счёта пользователя.
  • Блокировка средств (подробнее), с регистрацией повторяемой оплаты или без таковой. Для выполнения блокировки в платёжной платформе формируется операция auth, результатом выполнения которой является предварительная блокировка средств пользователя. Списание заблокированных средств или отмена их блокировки могут быть инициированыодним из следующих способов:
    • со стороны веб-сервиса мерчанта по запросу,
    • со стороны сотрудников мерчанта через интерфейс Dashboard,
    • со стороны платёжной платформы автоматически через заданный период.
  • Регистрация повторяемой оплаты. В рамках этого варианта регистрация повторяемой оплаты выполняется без фактического списания или блокировки средств пользователя. Для этого в платёжной платформе формируется операция contract registration, результатом выполнения которой является зарегистрированная повторяемая оплата.

В процессе проведения платежа могут выполняться одна или несколько вспомогательных процедур, однако дополнительных действий со стороны веб-сервиса при этом не требуется — все действия выполняются на стороне Payment Page.

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

  • reversal, если возврат инициируется до закрытия операционного дня, вне зависимости от суммы оплаты для карт платёжной системы Mastercard и при условии возврата всей суммы оплаты для карт других платёжных систем;
  • refund, если возврат инициируется для карт любых платёжных систем после закрытия операционного дня и вне зависимости от суммы, а также до закрытия операционного дня при условии возврата части суммы оплаты для карт всех платёжных систем, кроме Mastercard.
Рис. 1. Диаграмма состояний оплаты по платёжной ссылке в две стадии


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

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

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

error Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа
awaiting payment Проведение платежа инициировано, ожидается отправка платёжной ссылки Промежуточное состояние
expired Платёж не проведён из-за истечения срока действия платёжной ссылки Конечное состояние
invoice canceled Проведение платёжа отменено по инициативе мерчанта Конечное состояние
invoice sent Проведение платежа инициировано, платёжная ссылка отправлена Промежуточное состояние
processing Платёж проводится Промежуточное состояние
awaiting 3ds result Проведение платежа приостановлено до получения информации о результате аутентификации 3‑D Secure. Если такая информация не получена в течение установленного времени, то платёж переводится в статус decline. Как правило, время ожидания такой информации составляет 30 минут, но может варьироваться в зависимости от используемого провайдера. Для получения более подробной информации о времени ожидания следует обращаться к специалистам технической поддержки — support@ecommpay.com Промежуточное состояние
awaiting redirect result Проведение платежа приостановлено до получения со стороны платёжной системы уведомления с информацией о результате или о выполнении пользователем необходимых действий. В зависимости от результата на стороне платёжной системы платёж переводится в статус awaiting finalization, success или decline Промежуточное состояние
awaiting finalization Проведение платежа приостановлено до получения со стороны платёжной системы уведомления с информацией о результате. В этом случае со стороны пользователя не требуется никаких дополнительных действий, и в зависимости от результата на стороне платёжной системы платёж переводится в статус success или decline Промежуточное состояние
awaiting clarification Проведение платежа приостановлено до получения требуемой дополнительной информации. Если такая информация не получена в течение 30 минут, платёж переводится в статус decline Промежуточное состояние
awaiting customer Проведение платежа приостановлено до получения результата повторных попыток со стороны пользователя. При успешной повторной попытке платёж переводится в статус success, а при истечении числа безуспешных попыток — в статус decline (подробнее — в разделе Повторные попытки проведения платежей) Промежуточное состояние
awaiting capture Проведение платежа приостановлено до получения запроса на списание (capture) или на отмену предварительной блокировки средств (cancel) Промежуточное состояние
canceled Предварительная блокировка средств, выполненная по запросу auth, отменена Конечное состояние
decline Платёж отклонён Конечное состояние
success Платёж проведён Конечное состояние. Дополнительно допускается проведение возврата
partially reversed Сумма платежа частично возвращена до закрытия операционного дня, в котором он был проведён Конечное состояние
reversed Сумма платежа полностью возвращена до закрытия операционного дня, в котором он был проведён Конечное состояние. Дополнительно допускается отмена возврата
partially refunded Сумма платежа частично возвращена Конечное состояние. Дополнительно допускается отмена возврата
refunded Сумма платежа полностью возвращена после закрытия операционного дня, в котором он был проведён. Осуществлён один полный возврат суммы платежа или несколько частичных, в совокупности составляющих исходную сумму Конечное состояние. Дополнительно допускается отмена возврата

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

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

awaiting payment Выполнение операции инициировано, ожидается отправка платёжной ссылки Промежуточное состояние
expired Операция выполнена, срок действия платёжной ссылки истёк Конечное состояние
invoice canceled Выполнение операции отменено по инициативе мерчанта Конечное состояние
invoice sent Операция выполнена, платёжная ссылка отправлена Конечное состояние

Статусы операций sale и auth

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

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

Статусы операций capture и cancel

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

processing Операция выполняется Промежуточное состояние
awaiting clarification Выполнение операции приостановлено до получения требуемой дополнительной информации. Если такая информация не получена в течение 30 минут, операция переводится в статус decline Промежуточное состояние
decline Операция отклонена Конечное состояние
success Операция выполнена Конечное состояние

Статусы операции contract registration

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

Статусы операций reversal и refund

Статусы операций reversal и refund совпадают со статусами операций capture и cancel.