Оплата по платёжной ссылке
Общая информация
Оплата по платёжной ссылке — это тип платежа, в рамках которого на основании одного исходного запроса сначала создаётся и отправляется пользователю платёжная ссылка, а затем, при переходе по этой ссылке и подтверждении платежа, выполняется перевод или серия переводов денежных средств от пользователя к мерчанту..
Этот вариант может быть актуален, когда необходимо предоставлять пользователям возможность оплаты заказов без привязки к определённым месту и времени. Платёжные ссылки можно отправлять любым удобным способом: средствами 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.
Далее в рамках данного раздела представлена информация о возможных статусах оплаты по платёжной ссылке и связанных с ней операций. Более подробную информацию о проведении оплаты по платёжной ссылке можно найти в разделе 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 |
Операция выполнена | Конечное состояние |