Схема и статусы оплаты по платежной ссылке
Общая информация
Оплата по платежной ссылке — это тип платежа, в рамках которого на основании одного исходного запроса осуществляются создание и отправка платежной ссылки, а затем один (разовый) перевод денежных средств от пользователя к мерчанту, с предварительной блокировкой средств или без таковой.
Этот вариант может быть актуален, когда необходимо предоставлять пользователям возможность оплаты заказов без привязки к определенным месту и времени. Платежные ссылки можно отправлять любым удобным способом: средствами Rocketpay на электронную почту пользователя или самостоятельно другими способами, например в социальных сетях.
Схема проведения
Чтобы инициировать создание платежной ссылки, следует отправить в платформу запрос invoice/create
. Для выполнения такого запроса формируется операция invoice
, результатом которой является создание платежной ссылки и ее отправка в оповещении к веб-сервису, а также, при необходимости, в письме на электронную почту пользователя.
При необходимости после отправки платежной ссылки, но до подтверждения пользователем проведения платежа, действие платежной ссылки можно отменить. Для этого необходимо отправить в платежную платформу запрос категории invoice/cancel
.
Пользователю после перехода по платежной ссылке отображается платежная форма Payment Page, в которой он указывает свои платежные данные и подтверждает проведение оплаты. Далее, в зависимости от значения параметра card_operation_type
, переданного в запросе, оплата проводится в соответствии с одним из следущих вариантов:
- Разовая оплата в одну стадию. Для проведения этого варианта оплаты в платежной платформе формируется операция
sale
, результатом выполнения которой является списание средств со счета пользователя. - Разовая оплата в две стадии. Для проведения первой стадии этого варианта оплаты в платежной платформе формируется операция
auth
, результатом выполнения которой является предварительная блокировка средств пользователя. Вторая стадия такой оплаты может быть инициирована одним из следующих способов:- со стороны веб-сервиса мерчанта по запросу,
- со стороны платежной платформы автоматически через заданный период.
Для любого из вариантов оплаты по платежной ссылке в процессе проведения платежа могут выполняться одна или несколько вспомогательных процедур, однако дополнительных действий со стороны веб-сервиса при этом не требуется — все действия выполняются на стороне Payment Page.
После проведения оплаты по платежной ссылке можно выполнить возврат средств пользователю, если для использованного платежного метода поддерживается проведение возвратов. Чтобы инициировать возврат, следует отправить в платформу запрос категории refund
. Для выполнения такого запроса в платформе используется одна из следующих операций:
reversal
, если запрос обрабатывается в тот же бизнес-день, в котором был проведен платеж;refund
, если запрос обрабатывается после закрытия бизнес-дня, в котором был проведен платеж.
Рис.: Диаграмма состояний оплаты по платежной ссылке в две стадии
Далее в рамках данного раздела представлена информация о возможных статусах оплаты по платежной ссылке и связанных с ней операций. Более подробную информацию о проведении оплаты по платежной ссылке можно найти в разделе Оплата по платежной ссылке.
Статусы платежа
При проведении оплаты по платежной ссылке могут использоваться следующие статусы.
error |
Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса | Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа |
awaiting payment |
Проведение платежа инициировано, ожидается отправка платежной ссылки | Промежуточное состояние |
expired |
Платеж не проведен из-за истечения срока действия платежной ссылки | Конечное состояние |
invoice canceled |
Проведение платежа отменено по инициативе мерчанта | Конечное состояние |
invoice sent |
Проведение платежа инициировано, платежная ссылка отправлена | Промежуточное состояние |
processing |
Платеж проводится | Промежуточное состояние |
awaiting 3ds result |
Проведение платежа приостановлено до получения запроса на продолжение с учетом результата аутентификации 3‑D Secure — 3ds_result . Если такой запрос не получен в течение 30 минут, то платеж переводится в статус decline |
Промежуточное состояние |
awaiting redirect result |
Проведение платежа приостановлено до получения уведомления с результатом со стороны платежной системы. В зависимости от результата на стороне платежной системы платеж переводится в статус success или decline |
Промежуточное состояние |
awaiting clarification |
Проведение платежа приостановлено до получения запроса на продолжение с учетом требуемой дополнительной информации — 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 — 3ds_result . Если такой запрос не получен в течение 30 минут, операция переводится в статус decline |
Промежуточное состояние |
awaiting redirect result |
Выполнение операции приостановлено до получения уведомления с результатом от платежной системы. В зависимости от результата операция переводится в статус success или статус decline |
Промежуточное состояние |
awaiting clarification |
Выполнение операции приостановлено до получения запроса на продолжение с учетом требуемой дополнительной информации — clarification . Если такой запрос не получен в течение 30 минут, операция переводится в статус decline |
Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операций capture и cancel
При выполнении capture
и cancel
могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
awaiting clarification |
Выполнение операции приостановлено до получения запроса на продолжение с учетом требуемой дополнительной информации — clarification . Если такой запрос не получен в течение 30 минут, операция переводится в статус decline |
Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операций reversal и refund
Статусы операций reversal
и refund
совпадают со статусами операций capture
и cancel
.
Дополнительные материалы
При работе с оплатами по счету могут быть полезны следующие материалы:
- Общий порядок интеграции — раздел с общей информацией о взаимодействии с платежной платформой через Gate.
- Оплата по платежной ссылке — раздел с подробной информацией о проведении оплат по платежной ссылке.
- Оповещения (callbacks) в Gate — раздел с информацией об оповещениях и работе с ними.
- Статусы операций и коды ответов — раздел с информацией о кодах ошибок, используемых в платежной платформе.