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

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

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

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

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

Сформировать платёжную ссылку можно с помощью запроса invoice/create к Gate API или через интерфейс Dashboard. Для выполнения такого запроса формируется операция invoice, в результате которой платёжная ссылка:

  • формируется в платформе;
  • предоставляется инициатору;
  • отправляется пользователю, если это было задано.

Сформированную ссылку можно получить на стороне мерчанта через программное оповещение и интерфейс Dashboard — с учётом того, через какой интерфейс было инициировано создание ссылки. В свою очередь, отправка ссылки пользователю автоматически выполняется через платформу, если указывается такая необходимость и целевой адрес электронной почты. В Gate API для этого служат параметры send_email и email, в интерфейсе Dashboard — флажок Отправить e-mail покупателю и поле E-mail покупателя.

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

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

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

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

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

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

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

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

error Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа
awaiting payment Проведение платежа инициировано, ожидается отправка платёжной ссылки Промежуточное состояние
expired Платёж не проведён из-за истечения срока действия платёжной ссылки Конечное состояние
invoice canceled Проведение платёжа отменено по инициативе мерчанта Конечное состояние
invoice sent Проведение платежа инициировано, платёжная ссылка отправлена Промежуточное состояние
processing Платёж проводится Промежуточное состояние
awaiting redirect result Проведение платежа приостановлено до получения со стороны платёжной системы уведомления. В зависимости от результата на стороне платёжной системы платёж переводится в статус success или decline Промежуточное состояние
awaiting clarification Проведение платежа приостановлено до получения требуемой дополнительной информации. Если такая информация не получена в течение 30 минут, платёж переводится в статус decline Промежуточное состояние
decline Платёж отклонён Конечное состояние
success Платёж проведён Конечное состояние. Дополнительно допускается проведение возврата

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

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

awaiting payment

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

Промежуточное состояние

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

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

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

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