Оплата по платёжной ссылке
Общая информация
Оплата по платёжной ссылке — это тип платежа, в рамках которого на основании одного исходного запроса сначала создаётся и отправляется пользователю платёжная ссылка, а затем, при переходе по этой ссылке и подтверждении платежа, выполняется перевод или серия переводов денежных средств от пользователя к мерчанту. Как правило, оплаты по ссылкам используются для разовых расчётов, с предварительной блокировкой средств или без таковой. Вместе с тем, когда это актуально, при проведении оплат по ссылкам можно регистрировать повторяемые оплаты.
Этот вариант может быть актуален, когда необходимо предоставлять пользователям возможность оплаты заказов без привязки к определённым месту и времени. Платёжные ссылки можно отправлять любым удобным способом: средствами Flashpay на электронную почту пользователя или самостоятельно другими способами, например в социальных сетях.
Схема проведения
Сформировать платёжную ссылку можно с помощью запроса invoice/create к Gate API или через интерфейс Dashboard. Для выполнения такого запроса формируется операция invoice, в результате которой платёжная ссылка:
- формируется в платформе;
- предоставляется инициатору;
- отправляется пользователю, если это было задано.
Сформированную ссылку можно получить на стороне мерчанта через программное оповещение и интерфейс Dashboard — с учётом того, через какой интерфейс было инициировано создание ссылки. В свою очередь, отправка ссылки пользователю автоматически выполняется через платформу, если указывается такая необходимость и целевой адрес электронной почты. В Gate API для этого служат параметры send_email и email, в интерфейсе Dashboard — флажок Отправить e-mail покупателю и поле E-mail покупателя.
После формирования и отправки платёжной ссылки, но до того, как пользователь подтвердит проведение платежа, действие платёжной ссылки можно отменить. Для этого следует отправить в платёжную платформу запрос категории invoice/cancel или использовать переключатель Деактивировать в реестре платёжных ссылок интерфейса Dashboard.
Пользователю после перехода по платёжной ссылке отображается платёжная форма Payment Page, в которой он указывает свои платёжные данные и подтверждает проведение оплаты. Далее, в зависимости от значения параметра operation_type, переданного в запросе, платёж проводится в соответствии с одним из следущих вариантов:
- Разовая оплата в одну стадию. Для проведения этого варианта оплаты в платёжной платформе формируется операция
sale, результатом выполнения которой является списание средств со счёта пользователя. - Разовая оплата в две стадии. Для проведения первой стадии этого варианта оплаты в платёжной платформе формируется операция
auth, результатом выполнения которой является предварительная блокировка средств пользователя. Вторая стадия такой оплаты может быть инициирована одним из следующих способов:- со стороны веб-сервиса мерчанта по запросу,
- со стороны сотрудников мерчанта через интерфейс Dashboard,
- со стороны платёжной платформы автоматически через заданный период.
В процессе проведения платежа могут выполняться одна или несколько вспомогательных процедур, однако дополнительных действий со стороны веб-сервиса при этом не требуется — все действия выполняются на стороне Payment Page.
После проведения платежа можно выполнить возврат средств пользователю. Чтобы инициировать возврат, следует отправить в платформу запрос категории refund либо выбрать соответствующее действие в панели информации о платеже интерфейса Dashboard. Для выполнения возврата в зависимости от того, когда, на какую сумму и для какого платёжного инструмента инициируется возврат, формируется одна из следующих операций:
reversal, если возврат инициируется до закрытия операционного дня, вне зависимости от суммы оплаты для карт платёжной системы Mastercard и при условии возврата всей суммы оплаты для карт других платёжных систем;refund, если возврат инициируется для карт любых платёжных систем после закрытия операционного дня и вне зависимости от суммы, а также до закрытия операционного дня при условии возврата части суммы оплаты для карт всех платёжных систем, кроме Mastercard.
Далее в рамках данного раздела представлена информация о возможных статусах оплаты по платёжной ссылке и связанных с ней операций. Более подробную информацию о проведении оплаты по платёжной ссылке можно найти в разделах Gate и Dashboard.
Статусы платежа
При проведении оплаты по платёжной ссылке могут использоваться следующие статусы.
error |
Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса | Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа |
awaiting payment |
Проведение платежа инициировано, ожидается отправка платёжной ссылки | Промежуточное состояние |
expired |
Платёж не проведён из-за истечения срока действия платёжной ссылки | Конечное состояние |
invoice canceled |
Проведение платёжа отменено по инициативе мерчанта | Конечное состояние |
invoice sent |
Проведение платежа инициировано, платёжная ссылка отправлена | Промежуточное состояние |
processing |
Платёж проводится | Промежуточное состояние |
awaiting 3ds result |
Проведение платежа приостановлено до получения информации о результате аутентификации 3‑D Secure. Если такая информация не получена в течение установленного времени, то платёж переводится в статус decline. Как правило, время ожидания такой информации составляет 30 минут. Для получения более подробной информации о времени ожидания следует обращаться к специалистам технической поддержки — support@flashpay.kg |
Промежуточное состояние |
awaiting clarification |
Проведение платежа приостановлено до получения требуемой дополнительной информации. Если такая информация не получена в течение 30 минут, платёж переводится в статус 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@flashpay.kg |
Промежуточное состояние |
awaiting clarification |
Выполнение операции приостановлено до получения требуемой дополнительной информации. Если такая информация не получена в течение 30 минут, операция переводится в статус decline |
Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операций capture и cancel
При выполнении capture и cancel могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
awaiting clarification |
Выполнение операции приостановлено до получения требуемой дополнительной информации. Если такая информация не получена в течение 30 минут, операция переводится в статус decline |
Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операций reversal и refund
Статусы операций reversal и refund совпадают со статусами операций capture и cancel.