Схема и статусы повторяемой оплаты со списаниями по запросу
Общая информация
Повторяемая оплата со списаниями по запросу — это тип платежа, в рамках которого на основании одного исходного запроса осуществляется один (повторяемый) перевод денежных средств от пользователя к мерчанту с использованием сохраненных платежных данных и без подтверждения подлинности платежного инструмента пользователя (такого, как ввод кода проверки подлинности карты).
Этот вариант может быть актуален, когда в рамках обслуживания пользователя необходимо неоднократно проводить оплату с использованием одного и того же платежного инструмента без привязки к графику или сумме платежа (например, при предоставлении услуг такси). Для пользователя такие оплаты могут быть удобны тем, что с его стороны нет необходимости каждый раз вводить одни и те же платежные данные и подтверждать подлинность платежного инструмента.
Схема проведения
До проведения повторяемой оплаты требуется провести первоначальный платеж — разовую оплату или проверку действительности платежного инструмента — с сохранением в платформе платежных данных пользователя и с указанием типа повторяемой оплаты. Для этого в запросе на первоначальный платеж должен быть передан объект recurring
с указанием параметров register
и type
.
Чтобы инициировать повторяемую оплату, следует отправить в платформу запрос recurring
. Для выполнения такого запроса в платформе формируется операция recurring
, результатом выполнения которой является списание средств пользователя без подтверждения подлинности платежного инструмента.
Для проведения повторяемой оплаты со списаниями по запросу в редких случаях может требоваться отправка дополнительного запроса, если необходимо уточнение информации для какой-либо из сторон, участвующих в проведении платежа (например, предоставление в платежную систему адреса держателя карты, не переданного в исходном запросе). В таких случаях от платформы в веб-сервис отправляется оповещение с названиями параметров для уточнения и проведение платежа в платформе приостанавливается до получения от веб-сервиса запроса с необходимой информацией — clarification
.
Если для использованного платежного метода поддерживается проведение возвратов, то после проведения повторяемой оплаты со списаниями по запросу по этой оплате можно выполнить возврат средств пользователю. Чтобы инициировать возврат, следует отправить в платформу запрос категории refund
. Для выполнения такого запроса в платформе используется одна из следующих операций:
reversal
, если запрос обрабатывается в тот же бизнес-день, в котором был проведен платеж;refund
, если запрос обрабатывается после закрытия бизнес-дня, в котором был проведен платеж.
Рис.: Диаграмма состояний повторяемой оплаты со списаниями по запросу
Далее в рамках данного раздела представлена информация о возможных статусах повторяемой оплаты со списаниями по запросу и связанных с ней операций. Более подробную информацию о проведении повторяемых оплат можно найти в разделе Повторяемая оплата.
Статусы платежа
При проведении повторяемой оплаты со списаниями по запросу могут использоваться следующие статусы.
error |
Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса | Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа |
processing |
Платеж проводится | Промежуточное состояние |
awaiting clarification |
Проведение платежа приостановлено до получения запроса на продолжение с учетом требуемой дополнительной информации — clarification . Если такой запрос не получен в течение 30 минут, платеж переводится в статус decline |
Промежуточное состояние |
decline |
Платеж отклонен | Конечное состояние |
success |
Платеж проведен | Конечное состояние. Дополнительно допускается проведение возврата |
reversed |
Сумма платежа полностью возвращена до закрытия бизнес-дня, в котором он был проведен | Конечное состояние. Дополнительно допускается отмена возврата |
partially refunded |
Сумма платежа частично возвращена | Конечное состояние. Дополнительно допускается отмена возврата |
refunded |
Сумма платежа полностью возвращена после закрытия бизнес-дня, в котором он был проведен. Осуществлен один полный возврат суммы платежа или несколько частичных, в совокупности составляющих исходную сумму | Конечное состояние. Дополнительно допускается отмена возврата |
Статусы операции recurring
При выполнении операции recurring
могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
awaiting clarification |
Выполнение операции приостановлено до получения запроса на продолжение с учетом требуемой дополнительной информации — clarification . Если такой запрос не получен в течение 30 минут, операция переводится в статус decline |
Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операций reversal и refund
Статусы операций reversal
и refund
совпадают со статусами операции recurring
.
Дополнительные материалы
При работе с повторяемыми оплатами могут быть полезны следующие материалы:
- Общий порядок интеграции — раздел с общей информацией о взаимодействии с платежной платформой через Gate.
- Повторяемая оплата — раздел с подробной информацией о проведении повторяемых оплат.
- Оповещения (callbacks) в Gate — раздел с информацией об оповещениях и работе с ними.
- Статусы операций и коды ответов — раздел с информацией о кодах ошибок, используемых в платежной платформе.